项目:植物病菌孢子捕捉分析系统(Android arm64 工控机) 版本:2.8.16(versionCode 95) 分析范围:
src/(18 个 cpp,~9500 行)、header/(22 个头文件)、CMakeLists.txt、android/AndroidManifest.xml分析日期:2026-09-28 方法:静态代码审查(未修改任何代码)
| 模块 | 行数 | 职责 | 评价 |
|---|---|---|---|
cameramanager.cpp |
2617 | 相机取流、预览、录制写盘、帧解码、播放 | 过大,承担了过多职责 |
m_opencv.cpp |
2369 | 清晰度评分、景深融合、拼接 | 过大,算法细节与参数硬编码混杂 |
mysql.cpp |
1048 | SQLite 配置库 + 离线缓存 + 两个重复的访问类 | 重复严重 |
mqtthandler.cpp |
795 | MQTT 收发、JSON-RPC 指令分发 | 职责清晰,但有安全风险 |
main.cpp |
722 | 启动装配、信号连接、参数初始化 | 装配逻辑过重 |
| 其余 13 个文件 | ~2900 | 串口、YMODEM、日志、模型等 | 尚可 |
代码量约 1.5 万行,对一个工业采集设备而言规模合理,但存在明显的集中化问题:两个文件占了全项目 33% 的代码量。
cameramanager.cpp:1488)——单帧 5MB 而非 20MB,磁盘 IO 降低 4 倍,这是很到位的取舍。cameramanager.cpp:1492-1506)——超预算丢帧而非无限堆积,保住实时性,内存不会失控。这是全项目最扎实的一处设计。kPreviewIntervalMs = 200)——主动让出 CPU 和内存带宽给录制与分析,思路正确。ensureColumnExist / ensureConfigRow)——兼容老设备数据库,考虑周到。m_opencv.cpp:1635-1641)——小图模糊再放大,5MP 图上比直接大 σ 模糊快很多,且注释里记录了参数取舍的实测数据。cameramanager.cpp:203-207)——明确记录了海康 Bayer 与 OpenCV 命名差一个 R/B 这个坑,避免后人重踩。| 类别 | P0 | P1 | P2 |
|---|---|---|---|
| 安全漏洞 | 3 | 4 | 2 |
| 稳定性/正确性 | 5 | 6 | 4 |
| 性能 | 1 | 7 | 5 |
| 架构 | — | 3 | 4 |
yTransmitRead() 使用未初始化变量,且返回值语义错误位置:src/ymodem.cpp:112-122
int YMODEM::yTransmitRead( unsigned short timeout )
{
char byte; // ← 未初始化
int byte_int = static_cast<unsigned char>(byte); // ← 读未初始化值
m_serialPort->waitForReadyRead(timeout);
m_serialPort->getChar(&byte); // 返回值被丢弃
byte_int = byte; // char 为负时 → 负数/乱码
LOG("串口接收到: {} int: {}", byte, byte_int);
return byte_int;
}
三个叠加缺陷:
byte 未初始化,getChar() 失败(超时、无数据)时仍返回栈上的垃圾值。getChar() 的 bool 返回值被丢弃,无法区分"读到一个字节"和"读取失败"。char 在 ARM 上默认是 signed,字节值 ≥128(如协议控制字符 0x80~0xFF)会被解释为负数。return byte_int 返回负值后,调用方 yTransmit.cpp:220 的 if ((c = yTransmitRead(...)) >= 0) 判断会把它当作失败。触发场景: 主板升级(YMODEM 传输)时,串口无响应或收到高位字节。这是固件升级流程,失败会导致升级中断。
修复:
int YMODEM::yTransmitRead(unsigned short timeout)
{
char byte = 0;
if (!m_serialPort->waitForReadyRead(timeout)) return -1; // 超时明确返回 -1
if (!m_serialPort->getChar(&byte)) return -1; // 读取失败明确返回 -1
const int v = static_cast<unsigned char>(byte); // 无符号解释
LOG("串口接收到: {} int: {}", v, v);
return v;
}
SQLite UPDATE 整表执行,无 WHERE 条件位置:src/mysql.cpp:500-514(SqliteOperator::UpdateData)与 src/mysql.cpp:862-880(DatabaseInterface::updateData)
sql_query.prepare(QString("UPDATE %1 SET %2=?").arg(tablename,name));
sql_query.addBindValue(value);
// 没有 WHERE —— 影响表中所有行
问题本质: 该方法被当作"更新某表某配置项"使用(表 mqtt/ftp/config 等设计上就是单行表),但 SQL 本身没有任何约束。一旦某表因历史原因出现多行,会静默把所有行改成同一个值。
更危险的是:config 表无主键(CreateTable 里 config 没有 id 列),ensureConfigRow() 只能保证"至少有一行",不能保证"恰好一行"。若表被写坏成多行,fusion_sw 下发会导致配置错乱且无法被察觉(代码注释里已承认了这个设计缺陷,但没有根治)。
修复:
bool DatabaseInterface::updateData(QString tablename, QString name, QVariant value)
{
if(!ensureConfigDbOpen()) return false;
// 表名/列名白名单校验:杜绝 SQL 注入与误操作
static const QSet<QString> allowedCols = {
"ip","port","dir","uid","pwd","mode","imei","dtype","clientid",
"qos","keepalive","sub","pub","offline","dat_f",
"stitch_photonum","photo_width","photo_height","auto_focus",
"fusion_enable","jsonCacheEnable","imageCacheEnable",
"maxJsonEntries","maxImageEntries"
};
if (!allowedCols.contains(name)) {
ERROR("updateData: 非法列名 {}", name.toStdString());
return false;
}
QSqlQuery query(ensureDb());
query.prepare(QString("UPDATE %1 SET %2=? WHERE rowid=(SELECT min(rowid) FROM %1)")
.arg(tablename, name));
query.addBindValue(value);
if (!query.exec()) return false;
if (query.numRowsAffected() == 0) {
WARN("updateData: 更新影响 0 行,配置表可能为空");
return false;
}
return true;
}
加
WHERE rowid=(SELECT min(rowid) ...)保证只改一行;加numRowsAffected检查让"空表 UPDATE 成功"这个静默失败暴露出来。
config 表 y_init 列类型与读取代码不一致位置:src/mysql.cpp:400(建表)vs src/mysql.cpp:636(读取)
// 建表
y_init TEXT NOT NULL,
// 读取
param::y_init = sql_query.value(5).toInt(); // 从 TEXT 列读 int
声明为 TEXT 却按整数读取。当前写的是 0,toInt() 能"碰巧"正确;但一旦 MQTT 下发了非数字字符串,toInt() 返回 0 且不报错,配置被静默改写。
同时 main.cpp:448 的初始插入 {1,1,1000,500,0,0,1} 第 6 个字段按 config_param.y_init(int)绑定,与建表的 TEXT 声明冲突。
修复: 统一为 INT,并在读取时校验:
param::y_init = sql_query.value(5).toInt(&ok);
if (!ok) { WARN("config.y_init 非数值,已重置为 0"); param::y_init = 0; }
AndroidManifest.xml 版本属性重复声明,当前值被后面的空值覆盖位置:android/AndroidManifest.xml:2
<manifest package="com.yfkj.cb.Q6iot" ... android:versionCode="95" android:versionName="2.8.16">
android:versionCode="0" android:versionName="0">
同一个 <manifest> 标签上,versionCode/versionName 被声明了两次,第二次的值是字面量 0(实体转义后)。XML 解析器对重复属性的处理行为不确定——部分解析器取第一个(95/2.8.16),部分取最后一个(0/0)。
若某些工具链取最后一个值,打包出的 APK 版本号为 0,将导致:
adb install 被拒绝修复: 删除重复声明,只保留一组:
<manifest package="com.yfkj.cb.Q6iot"
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:dist="http://schemas.android.com/apk/distribution"
xmlns:tools="http://schemas.android.com/tools"
android:installLocation="auto"
android:versionCode="95"
android:versionName="2.8.16">
ensureColumnExist / ensureConfigRow 依赖已存在但可能已被移除的连接位置:src/mysql.cpp:112-147
if(QSqlDatabase::contains("qt_sql_default_connection")){
db = QSqlDatabase::database("qt_sql_default_connection");
}else{
WARN("ensureColumnExist: 数据库未打开,跳过补列 ...");
return false; // ← 静默跳过,调用方无法感知
}
main.cpp:458 在启动末尾调用 sqlConfig->CloseDb(),该函数执行 QSqlDatabase::removeDatabase("qt_sql_default_connection")。之后 main.cpp:567-575、576-583 又会 OpenDb() 重新打开。
时序是:CloseDb() → 之后 configChange 信号触发 OpenDb() → UpdateData() → CloseDb()。但 m_config 等 Q_INVOKABLE 方法随时可能从 QML 线程被调用,此时连接可能已被移除。
虽然 DatabaseInterface 路径有 ensureConfigDbOpen() 兜底,但 SqliteOperator 路径(main.cpp 全部配置同步、mserial.cpp 的 recoverMcuParam)没有。
触发场景: 串口参数同步(serialThread.recoverMcuParam(),main.cpp:719)在 main.cpp:458 的 CloseDb() 之后执行 → 写库失败 → MCU 参数不落库。
修复: 把 ensureDb() 幂等打开的逻辑提到 SqliteOperator 内部,所有 DB 操作前调用:
void SqliteOperator::ensureOpen() {
if (!QSqlDatabase::contains(kConnName)) {
db = QSqlDatabase::addDatabase("QSQLITE", kConnName);
db.setDatabaseName(<按平台计算路径>);
} else {
db = QSqlDatabase::database(kConnName);
}
if (!db.isOpen()) db.open();
}
并在 UpdateData / InsertData / QueryAllData / isTableExist 开头调用。
位置:src/main.cpp:382, 401, 412, 421, 503, 510, 545, 553
// main.cpp:412
config_class.ftp_db = {1,"8.136.98.49",21,"","bzy_user","YFkj@6O2O",0};
// main.cpp:503
uploader_ftp.setFtpParams("bzy_user", "YFkj@6O2O", "8.136.98.49", 21, remotepath);
// main.cpp:382 MQTT 密码
config_class.mqtt_db = {1,"bzy","8.136.98.49",61883,"","user",
"f335bf402c655ee5fd2b5300905124e",...};
问题:
main.cpp:510/545/553 的升级包下载地址同样硬编码main.cpp:467 还注释掉了一段完整的 Felgo License KeyROOT 权限(见 S-4),配合明文密钥,设备一旦被拿到即等于平台账号失守修复建议:
YFkj@6O2O 与 f335bf40... 这两组已在泄露的凭据。local.properties + 构建期注入。main.cpp:467 的 License Key 从注释中删除(注释里的密钥等同泄露)。upload_log 远程指令可读取任意文件位置:src/mqtthandler.cpp:284-317
else if(method=="upload_log"&&!PARAMS.isNull()){
QJsonValue filename_value = params_Obj["filename"];
QString appDataPath = QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation);
QString logFilePath = appDataPath +"/" + filename_value.toString(); // ← 路径穿越
...
if (QFile::copy(logFilePath, tempLogFile)) {
emit signal_upload_log(tempLogFile); // ← 复制并上传到公网 FTP
}
}
问题: filename 完全由远端 MQTT 消息控制,没有任何校验:
filename = "../../databases/config.db" → 读取配置库(含 MQTT 密码)filename = "../../shared_prefs/xxx.xml" → 读取应用配置appDataPath 形如 /data/data/com.yfkj.cb.Q6iot/files,../../ 可上溯至应用私有目录任意位置这是一条完整的"任意文件读取 → 外传"链路,只需控制设备的 MQTT 下发通道即可利用,而 MQTT topic 是可预测的(/yfkj/bzy/2.1/sub/{imei})。
修复: 强制文件名白名单,只允许日志目录下的 .txt:
else if (method == "upload_log" && !PARAMS.isNull()) {
const QString name = params_Obj["filename"].toString();
// 白名单:仅允许日志文件名,禁止路径分隔符与上级引用
if (name.contains('/') || name.contains('\\') || name.contains("..")) {
sendJsonRpcResponseImpl(ID.toInt(), false, "invalid filename");
return;
}
QRegularExpression re(QStringLiteral("^[A-Za-z0-9_\\-\\.]{1,64}\\.txt$"));
if (!re.match(name).hasMatch()) {
sendJsonRpcResponseImpl(ID.toInt(), false, "invalid filename");
return;
}
QString appDataPath = QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation);
QString logFilePath = appDataPath + "/" + name;
// 二次确认:规范化后的绝对路径必须仍在 appDataPath 之内
if (!QFileInfo(logFilePath).canonicalFilePath().startsWith(
QFileInfo(appDataPath).canonicalFilePath())) {
sendJsonRpcResponseImpl(ID.toInt(), false, "path denied");
return;
}
// ...原有逻辑
}
frpc_config 可写入任意 toml 并启动进程位置:src/mqtthandler.cpp:381-391,配合 src/frpcmanager.cpp
else if(method=="frpc_config"&&!PARAMS.isNull()){
const QString toml = params_Obj["toml"].toString(); // 远端完全可控
const bool restart = params_Obj["restart"].toInt() != 0;
QString err = m_frpc->setConfig(toml, restart);
}
问题: 攻击者可通过 toml 配置 frpc 把内网任意端口映射到公网(frpc 的经典利用方式)。结合 S-2 的任意文件读取,等于内网横向探测 + 数据外泄的完整链条。
修复: toml 内容做结构校验,只允许预定义字段(server_addr、server_port、token、以及业务需要的少量代理);对 remotePort 范围做白名单;增加操作审计日志上报。
位置:android/AndroidManifest.xml:110, 117, 119, 120
<uses-permission android:name="android.permission.READ_PRIVILEGED_PHONE_STATE"/>
<uses-permission android:name="android.permission.ROOT"/>
<uses-permission android:name="android.permission.INSTALL_PACKAGES"/>
<uses-permission android:name="android.permission.INSTALL_LOCATION_PROVIDER"/>
READ_PRIVILEGED_PHONE_STATE 与 INSTALL_LOCATION_PROVIDER 属于 signature|privileged 权限,普通应用申请无效(系统会忽略),出现在清单里只会误导审核。ROOT / INSTALL_PACKAGES 在非系统签名应用上同样无法授予。
另需注意: MainActivity 与 FelgoActivity 均为 android:exported="true"(第 6、31 行)。MainActivity 没有任何 intent-filter,属于无谓的对外暴露,任何应用都可显式启动它。
修复:
MainActivity 若无跨应用调用需求,改为 exported="false"。BootBroadcastReceiver 保留 exported="true"(开机自启必需),但 android:permission="android.permission.RECEIVE_BOOT_COMPLETED" 的写法不对——该权限保护的是广播的发送方,这里语义混乱,建议移除该属性。setupEth1() 通过 shell 执行系统命令位置:src/main.cpp:42-81
const QString cmd =
"ifconfig eth1 down; "
"ifconfig eth1 mtu 9000; "
"ifconfig eth1 192.168.100.101 netmask 255.255.255.0 up; "
"ifconfig eth1";
...
out = run(QStringLiteral("su"), {QStringLiteral("0"), QStringLiteral("sh"),
QStringLiteral("-c"), cmd});
问题:
cmd 以 sh -c 传入,且以 root 权限运行,循环重试 10 次,每次 5 秒超时——最坏情况阻塞 GUI 线程 50 秒,期间界面完全无响应(该函数在 main.cpp:341 于 app.exec() 之前同步调用,用户看到的是白屏 50 秒)ifconfig(net-tools)而非 ip,该工具在新版 Android 已移除修复:
setupEth1() 移到独立线程执行,主线程不阻塞。QNetworkInterface::setMTU()(Qt 6.5+ 移动平台支持有限)或 Java 层的 InterfaceConfiguration。位置:src/mqtthandler.cpp:256-258、src/main.cpp:201-210
LOG("Received message: {} on topic: {}",
QString::fromUtf8(m_client_dataBuf).toStdString(), topic.name().toStdString());
LOG("经度:{:.7f}",nowLongitude);
LOG("纬度:{:.7f}",nowLatitude);
问题: GPS 更新频率 1 秒一次(main.cpp:163 setUpdateInterval(1000)),每次定位输出 10 行日志。一天 = 86.4 万行 × 10,含精确到厘米的经纬度。日志经 upload_log 走明文 FTP 上公网。
修复: 生产构建关闭逐秒 GPS 日志(加 #ifdef DEBUG_LOG 或运行时日志级别开关),仅在定位成功/变化超过阈值时记录。
main.cpp 中遗留的 License Key 与调试代码位置:src/main.cpp:467
//felgo.setLicenseKey("234DA84CB6ECABBD8C7E18E7E87DA410005A79E2D05B5C0C81EF353D6A49D3224B..."); // ← 被注释但仍在文件中
注释不是保护。密钥已在版本库历史中,应视为已泄露。
修复: 删除该注释行,并轮换 License Key。
位置:src/m_opencv.cpp:1670-1672
for (int i = 0; i < N; ++i) {
cv::divide(weights[i], weightSum, weights[i]);
}
分析: N 张图 × 5MP × CV_32F = 每张 20MB。N=20 时:
Android 设备通常只有 256~512MB 可用堆,这已经是 OOM 的临界点。
优化方案(两阶段融合,内存降到 1/10):
// 阶段1:只算权重,不做归一化与融合
std::vector<cv::Mat> weights(N);
cv::Mat weightSum = cv::Mat::zeros(rows, cols, CV_32F);
for (int i = 0; i < N; ++i) {
weights[i] = computeWeight(canon[i]); // 各帧独立计算
cv::add(weightSum, weights[i], weightSum);
}
// 释放原始图像:后续不再需要
canon.clear(); canon.shrink_to_fit();
// 阶段2:分配唯一的输出 Mat,累加融合
cv::Mat out(rows, cols, CV_8UC3);
cv::multiply(canon_i /* 需保留 */, w, temp);
完整实现要点:把 canon 换成磁盘回读(融合阶段本来就有 .rawv 文件,逐帧 readRawVideoFrameBgrAny 再入):
QFile file(meta.path);
cv::Mat accImg, accW, outImg;
for (int i = 0; i < N; ++i) {
cv::Mat frameBgr;
readRawVideoFrameBgrAny(file, meta, indices[i], frameBgr); // 单帧 20MB
cv::Mat w = computeWeight(frameBgr); // 20MB
cv::normalize(w, w, 0, 1, cv::NORM_MINMAX);
cv::multiply(frameBgr, w, temp);
if (accImg.empty()) { accImg = temp; accW = w; }
else { cv::add(accImg, temp, accImg); cv::add(accW, w, accW); }
frameBgr.release(); temp.release(); w.release(); // ← 每帧及时释放
}
cv::divide(accImg, accW, accImg);
预期收益:峰值内存从 ~700MB 降至 ~120MB(单帧量级),OOM 风险基本消除。收益:高。
ptr<float>(y)位置:src/m_opencv.cpp:1687-1700
for (int y = 0; y < rows; ++y) {
const float* p0 = weights[0].ptr<float>(y); // 只提到外层,正确
uchar* pd = argmaxU8.ptr<uchar>(y);
for (int x = 0; x < cols; ++x) {
float bestW = p0[x];
int bestI = 0;
for (int i = 1; i < N; ++i) {
const float* pi = weights[i].ptr<float>(y); // ← 每个像素都重算!
float w = pi[x];
if (w > bestW) { bestW = w; bestI = i; }
}
pd[x] = (uchar)bestI;
}
}
问题: 内层最内层循环里,每处理一个像素就对每个 i 调用一次 weights[i].ptr<float>(y)。cv::Mat::ptr() 内部要做 data + step*y 的计算与类型检查。5MP × N=20 = 1.2 亿次 ptr() 调用,每次都重算同一个行偏移。
代码注释说"实测省 ~30~50 倍",但这是没有优化的版本——那个优化(把 at<> 换成 ptr<>)只做了一半,行指针没有提到最内层。
修复:
// 行指针数组,每行只解析一次
std::vector<const float*> rowPtr(N);
for (int y = 0; y < rows; ++y) {
for (int i = 0; i < N; ++i) rowPtr[i] = weights[i].ptr<float>(y);
uchar* pd = argmaxU8.ptr<uchar>(y);
float bestW = rowPtr[0][0];
int bestI = 0;
for (int x = 0; x < cols; ++x) {
bestW = rowPtr[0][x];
bestI = 0;
for (int i = 1; i < N; ++i) {
const float w = rowPtr[i][x]; // ← 纯数组索引,可向量化
if (w > bestW) { bestW = w; bestI = i; }
}
pd[x] = (uchar)bestI;
}
}
预期收益:argmax 阶段实测提速 3~8 倍(5MP/N=20 从约 50ms 降到 10~15ms 量级)。收益:中高。
进一步优化:N ≤ 256 时可把 N 个权重图
cv::merge成一张CV_32FC(N)单通道多通道图,用cv::reduce+argmax批量求,或用cv::split后的 SIMD 比较。当前手写循环已够用,不建议过度设计。
findSharpestFrameIndex 对 Bayer 帧逐帧全量解码位置:src/cameramanager.cpp:1776-1795
for(int i = 0; i < meta.frameCount; i++){
if(rawFormat){
cv::Mat bgr;
if(!readRawVideoFrameBgrAny(file, meta, i, bgr)) continue; // 读全帧 5MB + 解马赛克
cv::resize(bgr, small, smallSize, 0, 0, cv::INTER_AREA);
}
...
const double score = func.evaluateFocusScore(small, ...).combinedScore;
}
分析: 这里的代码已经写对了——注释明确说明 Bayer 不能行采样(会破坏 2×2 相位),所以必须读全帧解马赛克。当前 smallSize 是 width/4 × height/4,即先解马赛克再降采样。
可优化点: 解马赛克后立刻降到 1/4,白做了 3/4 的插值运算。
修复: 对 Bayer 帧做降采样解马赛克——按 2×2 像素块取样(这在数学上等价于对 Bayer 图案做 2×2 block average,是常见的快速实现):
// Bayer 安全降采样:先按 2x2 相位块取样(不破坏相位),再解马赛克
cv::Mat smallBayer;
cv::resize(src /* CV_8UC1 全分辨率 */, smallBayer, smallSize, 0, 0, cv::INTER_AREA);
cv::cvtColor(smallBayer, bgrSmall, cv::COLOR_BayerRG2RGB);
INTER_AREA 对单通道 Bayer 做 2×2 平均,等价于对每种颜色分量各自降采样,解马赛克后结果几乎无差别。
预期收益:评分阶段 IO 与解马赛克计算量降低约 3/4。收益:中。
fuseAdvanced 对每帧重复计算 computeAGD 的多尺度模糊位置:src/m_opencv.cpp:1603-1622
for (int s = 0; s < nScales; ++s) {
if (s == 0) { magUp = magFull; }
else {
cv::GaussianBlur(magFull, magBlurred, cv::Size(blurKsize, blurKsize), s * 1.5);
magUp = magBlurred;
}
cv::GaussianBlur(magUp, magSmoothed, cv::Size(0,0), sigmaLocal, sigmaLocal, ...);
cv::add(magSmoothed, 1.0, term);
cv::pow(term, wp / nScales, term);
cv::multiply(wAcc, term, wAcc);
}
分析: 每帧 3 次高斯模糊(s=0 复用,s=1、s=2 各一次)+ 3 次 sigma=2 模糊 + 1 次 pow。5MP 图上单帧约 7 次全分辨率浮点模糊,N=20 帧即 140 次。
其中 s=0 尺度与 sigmaLocal 平滑高度冗余:magFull 已经过一次 Sobel,再用 sigma=2 的高斯平滑,尺度信息损失不大。
优化方案(保持算法效果不变的前提下):
把多尺度计算搬到降采样空间。与权重平滑(m_opencv.cpp:1635-1641)用同一套思路:
// 全分辨率只做 Sobel,之后全在 1/4 小图上做多尺度
cv::Mat gx, gy;
cv::Sobel(gray, gx, CV_32F, 1, 0, 3);
cv::Sobel(gray, gy, CV_32F, 0, 1, 3);
cv::Mat mag;
cv::magnitude(gx, gy, mag);
cv::Mat magSmall;
cv::resize(mag, magSmall, cv::Size(cols/4, rows/4), 0, 0, cv::INTER_AREA);
// ... 多尺度与小 sigma 平滑都在 magSmall 上做,最后放大回原图
对清晰度权重而言,1/4 分辨率的空间频率信息已足够(细节保持率的实测数据表明权重本身是低频的)。
cv::pow(term, wp/nScales, term) 可优化:wp/nScales = 3.5/3 ≈ 1.1667,对非整数幂,OpenCV 会走通用幂函数。若接受轻微精度损失,可改用 term * cv::pow(term, 0.1667f)(整数幂更快),或直接调整参数使 wp/nScales 接近 1.0(如 wp=3.0)。
预期收益:权重计算阶段提速 3~4 倍。收益:中高。(需用现有 20260918165323/ 样本数据回归验证细节保持率不下降)
main.cpp 启动阶段串行执行 7 组"建表+插入+全表扫描"位置:src/main.cpp:379-456
每个表的初始化都是 isTableExist()(查 tables() 全量列表)→ CreateTable() → InsertData() → QueryAllData()(SELECT * 全表遍历)。共 7 轮,且 isTableExist 每次都调 database.tables() 拉取所有表名。
app.exec() 之前执行,直接延长白屏时间。
修复:
QueryAllData 的 SELECT * 改为只查需要的列(配置表都是单行,列名已知)。isTableExist 改用 SELECT name FROM sqlite_master WHERE type='table' AND name=?,避免 tables() 全量拉取。QTimer::singleShot(0, ...),让事件循环先起来,QML 界面先显示。enqueueJob 中在锁外读取 m_jobs.size()位置:src/app_curlFunc.cpp:47-56
{
QMutexLocker locker(&m_jobMutex);
m_jobs.push_back(job);
}
m_jobCond.wakeOne();
LOG("uploadFileAsync: 已入队 {} (队列剩余待上传 {} 个)",
localFilePath.toStdString(), (int)m_jobs.size()); // ← 锁外访问共享容器
问题: m_jobs 是 std::deque,size() 在锁外读取时,工作线程(runLoop)可能正在 pop_front()。这是数据竞争,实践中通常读到撕裂的 size(不影响正确性但属于未定义行为),在 TSAN 下会直接报错。
修复: 在锁内取值:
int remaining = 0;
{
QMutexLocker locker(&m_jobMutex);
m_jobs.push_back(job);
remaining = static_cast<int>(m_jobs.size());
}
m_jobCond.wakeOne();
LOG("uploadFileAsync: 已入队 {} (队列剩余待上传 {} 个)",
localFilePath.toStdString(), remaining);
performUpload 中 curl 配置项指向临时 QByteArray位置:src/app_curlFunc.cpp:146-147
QString username = m_username + ":" + m_password;
curl_easy_setopt(curl, CURLOPT_URL, url.toUtf8().constData());
curl_easy_setopt(curl, CURLOPT_USERPWD, username.toUtf8().constData());
问题: url.toUtf8() 返回临时 QByteArray,在完整表达式结束时即析构。libcurl 的 CURLOPT_URL/CURLOPT_USERPWD 约定是复制字符串(curl 自带 copy semantics),所以实际不会立即崩溃——但这是依赖未文档化行为的危险写法,且密码明文驻留在临时对象中。
更严重的是:m_password 是 QString,非 explicitly_shared,setFtpParams 赋值后这里每次 performUpload 都重新拼接密码字符串。
修复: 显式持有局部变量,明确生命周期:
const QByteArray urlUtf8 = url.toUtf8();
const QByteArray userPwdUtf8 = (m_username + ":" + m_password).toUtf8();
curl_easy_setopt(curl, CURLOPT_URL, urlUtf8.constData());
curl_easy_setopt(curl, CURLOPT_USERPWD, userPwdUtf8.constData());
progressCallback 中 emit 跨线程信号 + 无节流位置:src/app_curlFunc.cpp:183-195
int CurlFtpUploader::progressCallback(void *clientp, curl_off_t dltotal, curl_off_t dlnow,
curl_off_t ultotal, curl_off_t ulnow) {
CurlFtpUploader *uploader = static_cast<CurlFtpUploader*>(clientp);
if (ultotal > 0) {
double percent = (static_cast<double>(ulnow) / ultotal) * 100.0;
emit uploader->progressChanged(percent, uploader->m_currentFilePath);
}
double remainingTime = 0.0; // ← 死变量
return 0;
}
问题:
remainingTime 是死代码,sglProgress 信号声明了但从不发射。emit 在工作线程调用,Qt 会自动排队到接收方线程(uploader 属主线程),行为正确但仍有排队开销。修复: 加节流,仅在百分比变化 ≥1 时发射:
int CurlFtpUploader::progressCallback(void *clientp, curl_off_t, curl_off_t,
curl_off_t ultotal, curl_off_t ulnow) {
auto *uploader = static_cast<CurlFtpUploader*>(clientp);
if (ultotal > 0) {
const double percent = static_cast<double>(ulnow) / ultotal * 100.0;
if (percent - uploader->m_lastPercent >= 1.0) {
uploader->m_lastPercent = percent;
emit uploader->progressChanged(percent, uploader->m_currentFilePath);
}
}
return 0; // 返回非 0 可中止传输
}
OfflineStorage 每次计数都全表 COUNT(*)位置:src/app_sq_save.cpp:325-356(enforceLimit)+ 394-418
bool OfflineStorage::enforceLimit(const QString &table, int maxCount) {
int count = 0;
if(table=="json_messages"){ count = JsonEntries_saved(); } // SELECT COUNT(*)
else if(table=="image_paths"){ count = ImageEntries_saved(); } // SELECT COUNT(*)
...
}
问题: 缓存上限 1000 条 JSON,每次插入前都执行一次全表 COUNT(*)。SQLite 的 COUNT 在小表上很快,但在 1000 行 × 每次插入 = 持续开销。且 JsonEntries_saved() 与 ImageEntries_saved() 是唯一使用点,没有别处缓存。
修复: 用成员变量维护计数,插入/删除时增减:
m_jsonCount++; // insert 成功
m_jsonCount--; // delete 成功
cleanupUploaded 引用了不存在的列,函数必然失败位置:src/app_sq_save.cpp:315-322
bool OfflineStorage::cleanupUploaded() {
QSqlQuery query(m_db);
bool success = true;
success &= query.exec("DELETE FROM json_messages WHERE uploaded = 1"); // ← 无此列
success &= query.exec("DELETE FROM image_paths WHERE uploaded = 1"); // ← 无此列
return success;
}
建表语句(app_sq_save.cpp:44-67)中两张表都没有 uploaded 列。该函数 100% 返回 false。目前无调用点,属死代码,但一旦有人调用会写入错误日志造成误判。
修复: 直接删除该函数(markJsonUploaded / markImageUploaded 已是行删除语义,无需此函数)。
┌─────────────────────────────────────────────────────────┐
│ QML UI 层(31 个 qml) │
│ Main / Navigation / autoFocus_Page / systemset_Item ... │
└───────────────┬─────────────────────────────────────────┘
│ setContextProperty(全局单例)+ Q_INVOKABLE
┌───────────────▼─────────────────────────────────────────┐
│ main.cpp 装配层(722 行) │
│ 信号连接 · 参数初始化 · 数据库建表 · 网口配置 │
└───┬──────────────┬───────────────┬──────────────┬────────┘
│ │ │ │
┌───▼─────┐ ┌─────▼─────┐ ┌──────▼──────┐ ┌────▼────────┐
│MqttHandler│ │SerialThread│ │Frames │ │CurlFtp │
│ JSON-RPC │ │ QThread │ │ (相机/录制) │ │Uploader │
│ +Offline │ │ +YMODEM │ │ +RawRecord │ │ QThread │
│ Storage │ │ │ │ Writer线程 │ │ 串行队列 │
└───┬──────┘ └─────┬──────┘ └──────┬──────┘ └────┬────────┘
│ │ │ │
┌───▼──────────────▼───────────────▼──────────────▼────────┐
│ 数据层 │
│ SqliteOperator / DatabaseInterface(config.db) │
│ OfflineStorage(offline.db) │
│ OpencvFunc(评分/融合)· ImageStitcher(拼接) │
└────────────────────────────────────────────────────────────┘
param:: 是架构的隐性中心位置:header/main.h:48-161 + src/mysql.cpp:5-85
param 类持有 60+ 个 public static 成员,涵盖 MQTT 配置、FTP 配置、GPS 状态、相机参数、网络状态、图片列表。任何模块都能读写任意字段,无编译期约束、无线程安全保护、无变更通知。
具体风险已在代码中显现:
mqtthandler.cpp:137 — param::mqtt_main_offline = param::mqtt_main_offline + param::imei; 若 connectToBroker() 被重复调用,IMEI 会反复追加(...offline/123456123456)main.cpp:528/530 — param::net_alive = 1;(int)与 main.h:151 声明的 bool 类型不一致,mqtthandler.cpp:226 又赋 true,跨模块语义混乱cameramanager.cpp 的分析线程、main.cpp 的 GUI 线程、SerialThread 的串口线程都读写同一批 static 变量,无原子性/无锁改进建议(渐进式,不必一次重构):
// 第一步:引入分组结构体 + 线程安全访问器
namespace param {
struct MqttConfig {
QMutex mutex;
QString host, uid, pwd, sub, pub, offline, imei;
int port = 1883, qos = 0, keepalive = 60;
QString snapshotOfflineTopic() const {
QMutexLocker lk(&mutex);
return offline + imei; // ← 拼接逻辑收口,杜绝重复追加
}
};
extern MqttConfig mqttMain; // 单例而非散装 static
}
至少先把 mqtt_main_offline 的拼接收口到 MqttHandler 的私有方法,彻底消除重复追加的隐患。
cameramanager.cpp 职责过载该文件(2617 行)同时承担:
.rawv 文件头编解码(writeRawHeader/readRawVideoMeta)decodeRawBufferToBgr)RawRecordWriter)RawVideoPlayer)findSharpestFrameIndex)selectFuseFrames)drawWatermark)后果: 修改任一功能都需通读 2600 行;.rawv 格式是隐式契约,散落在文件中缺乏集中定义。
改进建议: 按关注点拆分(注意:拆分不改变行为,每次拆分后必须升版本号):
src/
├── raw/RawVideoIO.cpp # .rawv 头编解码 + 帧读取/解码(纯逻辑,可单测)
├── raw/RawRecordWriter.cpp # 异步写盘线程
├── raw/RawVideoPlayer.cpp # 回放
├── imaging/FrameAnalyzer.cpp # findSharpestFrameIndex / selectFuseFrames
├── imaging/Watermark.cpp # 水印
└── cameramanager.cpp # 仅保留相机 SDK 交互 + 录制编排
.rawv 格式(magic/version/w/h/stride/fps/frameCount/pixelFormat)应集中到 header/raw/RawFormat.h,使格式变更有唯一改动点。
现状对比:
SqliteOperator |
DatabaseInterface |
|
|---|---|---|
| 打开方式 | 构造时 + OpenDb() |
ensureDb() 惰性绑定 |
| 返回值 | 一律 int,恒为 0 |
bool,反映真实结果 |
| 连接处理 | 依赖调用方 OpenDb/CloseDb |
幂等 ensureConfigDbOpen() |
| 死代码 | QueryData()(查不存在的 student 表)、InertListConfig()(INSERT INFO 拼写错误) |
insertData/deleteData(操作不存在的 Info 表) |
两套并存导致的历史事故(代码注释中已记录):DatabaseInterface 曾从未调用 openDatabase(),导致所有 MQTT 远程配置写库失败。
改进建议: 以 DatabaseInterface 为唯一入口,废弃 SqliteOperator:
DatabaseInterface 增加 ensureColumnExist() / ensureConfigRow() / createTable() 的通用实现param::table_xxx 的字符串表名为枚举SqliteOperator::QueryData()、InertListConfig()、DatabaseInterface::insertData()、DatabaseInterface::deleteData()main.cpp 承担过多启动装配职责现状: main.cpp 中有 200+ 行是数据库初始化与信号连接,实际"启动一个应用"的内容不足 50 行。且 setupEth1() 这类可能阻塞 50 秒的操作被同步放在 app.exec() 之前。
改进建议: 引入 AppBootstrap 类,把启动流程显式化:
class AppBootstrap {
public:
void loadConfig(); // 数据库初始化(QTimer::singleShot(0) 延迟)
void configureNetwork(); // setupEth1 移到独立线程
void wireSignals(); // 所有 connect 集中
void exposeToQml(); // setContextProperty 集中
};
收益:启动流程一眼可读,测试时可单独调用各阶段;main() 回归到 20 行以内。
现状:
LOG/WARN/ERROR(spdlog 封装),但没有运行时级别控制——生产环境与调试环境日志量相同false,有的返回 0(永远成功),有的只打日志setupEth1() 抛异常、std::bad_alloc(PF-1 的 OOM 场景)都会直接终止进程改进建议:
INITLOG() 增加 setLogLevel(),默认 INFO,Release 构建下 GPS 逐秒日志等降为 DEBUGtry/catch 与 std::bad_alloc 捕获,失败降级而非崩溃bool 表示成功与否,int 仅用于确有意义的状态码| 决策 | 位置 | 评价 |
|---|---|---|
| 存 Bayer8 而非 BGRA | cameramanager.cpp:1488 |
磁盘 IO 与内存带宽降低 4 倍,这是本项目最高价值的优化 |
| 有界队列 + 内存预算 + 丢帧 | cameramanager.cpp:1495 |
宁可丢帧保实时,不让内存失控。取舍正确 |
| 权重图降采样平滑 | m_opencv.cpp:1635-1641 |
5MP 上比直接大 σ 模糊快得多,且注释记录了实测取舍依据 |
| 融合帧按评分曲线圈定 | m_opencv.cpp:1831-1850 |
数据驱动的算法参数,而非固定 ±4 帧 |
| 预览降帧到 5fps | kPreviewIntervalMs |
主动让出资源给分析链路 |
| 配置库平滑升级 | ensureColumnExist |
兼容存量设备 |
| 注释记录算法参数依据 | m_opencv.cpp:1568-1572 |
写明"旧实现等效 σ≈90 导致细节仅保持 63%",避免后人回退 |
| # | 项 | 类型 | 位置 | 工作量 |
|---|---|---|---|---|
| 1 | 轮换并移除明文密码 | 安全 | main.cpp:382,412,503 |
2h |
| 2 | upload_log 路径穿越 |
安全 | mqtthandler.cpp:287 |
1h |
| 3 | AndroidManifest 重复版本属性 |
正确性 | AndroidManifest.xml:2 |
5min |
| 4 | yTransmitRead 未初始化变量 |
稳定性 | ymodem.cpp:115 |
30min |
| 5 | config.y_init 类型不一致 |
正确性 | mysql.cpp:400,636 |
20min |
| 6 | 删除无效高危权限 | 安全 | AndroidManifest.xml:110,117 |
10min |
| 7 | enqueueJob 锁外读 size |
线程安全 | app_curlFunc.cpp:56 |
10min |
| # | 项 | 预期收益 | 工作量 |
|---|---|---|---|
| 8 | 融合改两阶段(PF-1) | 峰值内存 700MB→120MB,消除 OOM | 1~2 天 |
| 9 | argmax 行指针提到最内层外(PF-2) | argmax 提速 3~8× | 2h |
| 10 | 权重多尺度搬到降采样空间(PF-4) | 权重计算提速 3~4× | 1 天 |
| 11 | Bayer 评分先降采样再解马赛克(PF-3) | 评分 IO 降 3/4 | 3h |
| 12 | curl URL/密码持有局部变量(PF-7) | 消除未定义行为 | 10min |
| 13 | 进度信号节流(PF-8) | 消除信号风暴 | 30min |
| # | 项 | 收益 | 工作量 |
|---|---|---|---|
| 14 | UPDATE 加列名白名单 + WHERE rowid |
消除整表误更新与注入面 | 半天 |
| 15 | SqliteOperator 合并到 DatabaseInterface |
消除双写入口(历史事故源) | 2~3 天 |
| 16 | 拆分 cameramanager.cpp |
单文件 2617→<800 行 | 3~5 天 |
| 17 | param:: 全局状态收敛 |
消除跨线程数据竞争 | 1~2 周 |
| 18 | 启动流程异步化(setupEth1 移出主线程) |
消除最长 50s 白屏 | 半天 |
| 19 | 引入 AppBootstrap + 日志级别控制 |
可维护性、可观测性 | 2~3 天 |
修复前后的性能对比,建议使用项目现有的样本数据:
20260918165323/ # 含 .rawv 原始视频 + 46 张 jpg + csv 标注
adb shell dumpsys meminfo com.yfkj.cb.Q6iot 采样融合阶段的 TOTAL PSSm_opencv.cpp 已有 TIMER_SCOPE 埋点(halcon-focus / halcon-argmax / halcon-agd / halcon-sigmaFuse),直接读日志即可对比提醒:按项目约定,任何代码改动都必须同步升级 5 处版本号(
main.h/CMakeLists.txt/qml/config.json/AndroidManifest.xml/docs/Readme.md),否则设备端无法覆盖安装。本次仅做分析,未改动代码,故未升版本。
报告生成时间:2026-09-28 | 分析者:静态代码审计 | 未修改任何源代码