# q6_felgo_iot 代码分析报告 > 项目:植物病菌孢子捕捉分析系统(Android arm64 工控机) > 版本:2.8.16(versionCode 95) > 分析范围:`src/`(18 个 cpp,~9500 行)、`header/`(22 个头文件)、`CMakeLists.txt`、`android/AndroidManifest.xml` > 分析日期:2026-09-28 > 方法:静态代码审查(未修改任何代码) --- ## 目录 - [一、总体评估](#一总体评估) - [二、P0 级缺陷(必须修复)](#二p0-级缺陷必须修复) - [三、安全漏洞](#三安全漏洞) - [四、性能优化](#四性能优化) - [五、架构设计评估与建议](#五架构设计评估与建议) - [六、行动优先级总表](#六行动优先级总表) --- ## 一、总体评估 ### 1.1 规模与构成 | 模块 | 行数 | 职责 | 评价 | |---|---:|---|---| | `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% 的代码量。 ### 1.2 优点(值得保留的设计) 1. **录制存原始 Bayer8 而非 BGRA**(`cameramanager.cpp:1488`)——单帧 5MB 而非 20MB,磁盘 IO 降低 4 倍,这是很到位的取舍。 2. **写盘完全异步 + 有界队列 + 内存预算**(`cameramanager.cpp:1492-1506`)——超预算丢帧而非无限堆积,保住实时性,内存不会失控。这是全项目最扎实的一处设计。 3. **预览降帧到 5fps**(`kPreviewIntervalMs = 200`)——主动让出 CPU 和内存带宽给录制与分析,思路正确。 4. **配置库平滑升级机制**(`ensureColumnExist` / `ensureConfigRow`)——兼容老设备数据库,考虑周到。 5. **权重图降采样平滑**(`m_opencv.cpp:1635-1641`)——小图模糊再放大,5MP 图上比直接大 σ 模糊快很多,且注释里记录了参数取舍的实测数据。 6. **YMODEM 通道顺序注释**(`cameramanager.cpp:203-207`)——明确记录了海康 Bayer 与 OpenCV 命名差一个 R/B 这个坑,避免后人重踩。 ### 1.3 主要风险概览 | 类别 | P0 | P1 | P2 | |---|---:|---:|---:| | 安全漏洞 | 3 | 4 | 2 | | 稳定性/正确性 | 5 | 6 | 4 | | 性能 | 1 | 7 | 5 | | 架构 | — | 3 | 4 | --- ## 二、P0 级缺陷(必须修复) ### P0-1 `yTransmitRead()` 使用未初始化变量,且返回值语义错误 **位置**:`src/ymodem.cpp:112-122` ```cpp int YMODEM::yTransmitRead( unsigned short timeout ) { char byte; // ← 未初始化 int byte_int = static_cast(byte); // ← 读未初始化值 m_serialPort->waitForReadyRead(timeout); m_serialPort->getChar(&byte); // 返回值被丢弃 byte_int = byte; // char 为负时 → 负数/乱码 LOG("串口接收到: {} int: {}", byte, byte_int); return byte_int; } ``` **三个叠加缺陷:** 1. `byte` 未初始化,`getChar()` 失败(超时、无数据)时仍返回栈上的垃圾值。 2. `getChar()` 的 bool 返回值被丢弃,**无法区分"读到一个字节"和"读取失败"**。 3. `char` 在 ARM 上默认是 **signed**,字节值 ≥128(如协议控制字符 0x80~0xFF)会被解释为负数。`return byte_int` 返回负值后,调用方 `yTransmit.cpp:220` 的 `if ((c = yTransmitRead(...)) >= 0)` 判断会把它当作失败。 **触发场景:** 主板升级(YMODEM 传输)时,串口无响应或收到高位字节。这是**固件升级流程**,失败会导致升级中断。 **修复:** ```cpp 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(byte); // 无符号解释 LOG("串口接收到: {} int: {}", v, v); return v; } ``` --- ### P0-2 `SQLite UPDATE` 整表执行,无 WHERE 条件 **位置**:`src/mysql.cpp:500-514`(`SqliteOperator::UpdateData`)与 `src/mysql.cpp:862-880`(`DatabaseInterface::updateData`) ```cpp 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` 下发会导致配置错乱且**无法被察觉**(代码注释里已承认了这个设计缺陷,但没有根治)。 **修复:** ```cpp bool DatabaseInterface::updateData(QString tablename, QString name, QVariant value) { if(!ensureConfigDbOpen()) return false; // 表名/列名白名单校验:杜绝 SQL 注入与误操作 static const QSet 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 成功"这个静默失败暴露出来。 --- ### P0-3 `config` 表 `y_init` 列类型与读取代码不一致 **位置**:`src/mysql.cpp:400`(建表)vs `src/mysql.cpp:636`(读取) ```cpp // 建表 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`,并在读取时校验: ```cpp param::y_init = sql_query.value(5).toInt(&ok); if (!ok) { WARN("config.y_init 非数值,已重置为 0"); param::y_init = 0; } ``` --- ### P0-4 `AndroidManifest.xml` 版本属性重复声明,当前值被后面的空值覆盖 **位置**:`android/AndroidManifest.xml:2` ```xml android:versionCode="0" android:versionName="0"> ``` 同一个 `` 标签上,`versionCode`/`versionName` **被声明了两次**,第二次的值是字面量 `0`(实体转义后)。XML 解析器对重复属性的处理行为不确定——部分解析器取第一个(95/2.8.16),部分取最后一个(0/0)。 **若某些工具链取最后一个值,打包出的 APK 版本号为 0**,将导致: - Android 认为版本未升级,`adb install` 被拒绝 - 与项目约定"每次改动必须升版本号,否则装不上"的机制直接冲突 **修复:** 删除重复声明,只保留一组: ```xml ``` --- ### P0-5 `ensureColumnExist` / `ensureConfigRow` 依赖已存在但可能已被移除的连接 **位置**:`src/mysql.cpp:112-147` ```cpp 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 操作前调用: ```cpp 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` 开头调用。 --- ## 三、安全漏洞 ### S-1 【高】FTP/MQTT 账号密码明文硬编码 **位置**:`src/main.cpp:382, 401, 412, 421, 503, 510, 545, 553` ```cpp // 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",...}; ``` **问题:** - 设备生产口令、平台 MQTT 认证密钥以明文形式提交进源码与版本库 - `main.cpp:510/545/553` 的升级包下载地址同样硬编码 - `main.cpp:467` 还注释掉了一段完整的 **Felgo License Key** - AndroidManifest 申请了 `ROOT` 权限(见 S-4),配合明文密钥,设备一旦被拿到即等于平台账号失守 **修复建议:** 1. 立即**轮换** `YFkj@6O2O` 与 `f335bf40...` 这两组已在泄露的凭据。 2. 密钥移出源码,改为首次启动时由 MQTT 下发并存入 Android Keystore 加密,或走 `local.properties` + 构建期注入。 3. `main.cpp:467` 的 License Key 从注释中删除(注释里的密钥等同泄露)。 --- ### S-2 【高】`upload_log` 远程指令可读取任意文件 **位置**:`src/mqtthandler.cpp:284-317` ```cpp 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"` → 读取应用配置 - Android 上 `appDataPath` 形如 `/data/data/com.yfkj.cb.Q6iot/files`,`../../` 可上溯至应用私有目录任意位置 **这是一条完整的"任意文件读取 → 外传"链路**,只需控制设备的 MQTT 下发通道即可利用,而 MQTT topic 是可预测的(`/yfkj/bzy/2.1/sub/{imei}`)。 **修复:** 强制文件名白名单,只允许日志目录下的 `.txt`: ```cpp 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; } // ...原有逻辑 } ``` --- ### S-3 【中】`frpc_config` 可写入任意 toml 并启动进程 **位置**:`src/mqtthandler.cpp:381-391`,配合 `src/frpcmanager.cpp` ```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` 范围做白名单;增加操作审计日志上报。 --- ### S-4 【中】权限过度申请 **位置**:`android/AndroidManifest.xml:110, 117, 119, 120` ```xml ``` `READ_PRIVILEGED_PHONE_STATE` 与 `INSTALL_LOCATION_PROVIDER` 属于 **signature|privileged 权限**,普通应用申请无效(系统会忽略),出现在清单里只会误导审核。`ROOT` / `INSTALL_PACKAGES` 在非系统签名应用上同样无法授予。 **另需注意:** `MainActivity` 与 `FelgoActivity` 均为 `android:exported="true"`(第 6、31 行)。`MainActivity` 没有任何 intent-filter,属于**无谓的对外暴露**,任何应用都可显式启动它。 **修复:** 1. 删除四个无效/高危权限声明。 2. `MainActivity` 若无跨应用调用需求,改为 `exported="false"`。 3. `BootBroadcastReceiver` 保留 `exported="true"`(开机自启必需),但 `android:permission="android.permission.RECEIVE_BOOT_COMPLETED"` 的写法不对——该权限保护的是广播的**发送方**,这里语义混乱,建议移除该属性。 --- ### S-5 【中】`setupEth1()` 通过 shell 执行系统命令 **位置**:`src/main.cpp:42-81` ```cpp 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 已移除 **修复:** 1. 把 `setupEth1()` 移到独立线程执行,主线程不阻塞。 2. 减少重试次数与超时(如 3 次 × 2 秒),失败也不影响主流程。 3. 长期改用 `QNetworkInterface::setMTU()`(Qt 6.5+ 移动平台支持有限)或 Java 层的 `InterfaceConfiguration`。 --- ### S-6 【中】日志中打印完整 MQTT 报文与 GPS 坐标 **位置**:`src/mqtthandler.cpp:256-258`、`src/main.cpp:201-210` ```cpp LOG("Received message: {} on topic: {}", QString::fromUtf8(m_client_dataBuf).toStdString(), topic.name().toStdString()); ``` ```cpp LOG("经度:{:.7f}",nowLongitude); LOG("纬度:{:.7f}",nowLatitude); ``` **问题:** GPS 更新频率 **1 秒一次**(`main.cpp:163` `setUpdateInterval(1000)`),每次定位输出 10 行日志。一天 = 86.4 万行 × 10,含精确到厘米的经纬度。日志经 `upload_log` 走明文 FTP 上公网。 **修复:** 生产构建关闭逐秒 GPS 日志(加 `#ifdef DEBUG_LOG` 或运行时日志级别开关),仅在定位成功/变化超过阈值时记录。 --- ### S-7 【低】`main.cpp` 中遗留的 License Key 与调试代码 **位置**:`src/main.cpp:467` ```cpp //felgo.setLicenseKey("234DA84CB6ECABBD8C7E18E7E87DA410005A79E2D05B5C0C81EF353D6A49D3224B..."); // ← 被注释但仍在文件中 ``` 注释不是保护。密钥已在版本库历史中,应视为已泄露。 **修复:** 删除该注释行,并轮换 License Key。 --- ## 四、性能优化 ### PF-1 【高】融合权重归一化对 N 张图做 N 次全图 divide **位置**:`src/m_opencv.cpp:1670-1672` ```cpp for (int i = 0; i < N; ++i) { cv::divide(weights[i], weightSum, weights[i]); } ``` **分析:** N 张图 × 5MP × CV_32F = 每张 20MB。N=20 时: - 全部分配完成需要 **400MB 权重 Mat 同时驻留内存** - 加上 20 张 5MP BGR 原图(约 300MB),峰值内存逼近 **700MB** Android 设备通常只有 256~512MB 可用堆,这已经是 **OOM 的临界点**。 **优化方案(两阶段融合,内存降到 1/10):** ```cpp // 阶段1:只算权重,不做归一化与融合 std::vector 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` 再入): ```cpp 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 风险基本消除。收益:高。** --- ### PF-2 【高】argmax 内层循环重复调用 `ptr(y)` **位置**:`src/m_opencv.cpp:1687-1700` ```cpp for (int y = 0; y < rows; ++y) { const float* p0 = weights[0].ptr(y); // 只提到外层,正确 uchar* pd = argmaxU8.ptr(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(y); // ← 每个像素都重算! float w = pi[x]; if (w > bestW) { bestW = w; bestI = i; } } pd[x] = (uchar)bestI; } } ``` **问题:** 内层最内层循环里,每处理**一个像素**就对每个 `i` 调用一次 `weights[i].ptr(y)`。`cv::Mat::ptr()` 内部要做 `data + step*y` 的计算与类型检查。5MP × N=20 = **1.2 亿次 ptr() 调用**,每次都重算同一个行偏移。 代码注释说"实测省 ~30~50 倍",但这是**没有优化的版本**——那个优化(把 `at<>` 换成 `ptr<>`)只做了一半,行指针没有提到最内层。 **修复:** ```cpp // 行指针数组,每行只解析一次 std::vector rowPtr(N); for (int y = 0; y < rows; ++y) { for (int i = 0; i < N; ++i) rowPtr[i] = weights[i].ptr(y); uchar* pd = argmaxU8.ptr(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 比较。当前手写循环已够用,不建议过度设计。 --- ### PF-3 【中】`findSharpestFrameIndex` 对 Bayer 帧逐帧全量解码 **位置**:`src/cameramanager.cpp:1776-1795` ```cpp 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,是常见的快速实现): ```cpp // 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。收益:中。** --- ### PF-4 【中】`fuseAdvanced` 对每帧重复计算 `computeAGD` 的多尺度模糊 **位置**:`src/m_opencv.cpp:1603-1622` ```cpp 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 的高斯平滑,尺度信息损失不大。 **优化方案(保持算法效果不变的前提下):** 1. **把多尺度计算搬到降采样空间**。与权重平滑(`m_opencv.cpp:1635-1641`)用同一套思路: ```cpp // 全分辨率只做 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 分辨率的空间频率信息已足够(细节保持率的实测数据表明权重本身是低频的)。 2. **`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/` 样本数据回归验证细节保持率不下降) --- ### PF-5 【中】`main.cpp` 启动阶段串行执行 7 组"建表+插入+全表扫描" **位置**:`src/main.cpp:379-456` 每个表的初始化都是 `isTableExist()`(查 `tables()` 全量列表)→ `CreateTable()` → `InsertData()` → `QueryAllData()`(`SELECT *` 全表遍历)。共 7 轮,且 `isTableExist` 每次都调 `database.tables()` 拉取**所有表名**。 `app.exec()` 之前执行,直接延长白屏时间。 **修复:** 1. `QueryAllData` 的 `SELECT *` 改为只查需要的列(配置表都是单行,列名已知)。 2. `isTableExist` 改用 `SELECT name FROM sqlite_master WHERE type='table' AND name=?`,避免 `tables()` 全量拉取。 3. 更好:把配置初始化整体搬到 `QTimer::singleShot(0, ...)`,让事件循环先起来,QML 界面先显示。 --- ### PF-6 【中】`enqueueJob` 中在锁外读取 `m_jobs.size()` **位置**:`src/app_curlFunc.cpp:47-56` ```cpp { 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 下会直接报错。 **修复:** 在锁内取值: ```cpp int remaining = 0; { QMutexLocker locker(&m_jobMutex); m_jobs.push_back(job); remaining = static_cast(m_jobs.size()); } m_jobCond.wakeOne(); LOG("uploadFileAsync: 已入队 {} (队列剩余待上传 {} 个)", localFilePath.toStdString(), remaining); ``` --- ### PF-7 【中】`performUpload` 中 curl 配置项指向临时 QByteArray **位置**:`src/app_curlFunc.cpp:146-147` ```cpp 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` 都重新拼接密码字符串。 **修复:** 显式持有局部变量,明确生命周期: ```cpp 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()); ``` --- ### PF-8 【低】`progressCallback` 中 `emit` 跨线程信号 + 无节流 **位置**:`src/app_curlFunc.cpp:183-195` ```cpp 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(clientp); if (ultotal > 0) { double percent = (static_cast(ulnow) / ultotal) * 100.0; emit uploader->progressChanged(percent, uploader->m_currentFilePath); } double remainingTime = 0.0; // ← 死变量 return 0; } ``` **问题:** 1. libcurl 在**传输过程中持续回调**,5MB 图在慢速 FTP 上可能每秒触发数十次 → 信号风暴,QML 端绑定更新无节流。 2. `remainingTime` 是死代码,`sglProgress` 信号声明了但从不发射。 3. `emit` 在工作线程调用,Qt 会自动排队到接收方线程(`uploader` 属主线程),行为正确但仍有排队开销。 **修复:** 加节流,仅在百分比变化 ≥1 时发射: ```cpp int CurlFtpUploader::progressCallback(void *clientp, curl_off_t, curl_off_t, curl_off_t ultotal, curl_off_t ulnow) { auto *uploader = static_cast(clientp); if (ultotal > 0) { const double percent = static_cast(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 可中止传输 } ``` --- ### PF-9 【低】`OfflineStorage` 每次计数都全表 COUNT(*) **位置**:`src/app_sq_save.cpp:325-356`(`enforceLimit`)+ `394-418` ```cpp 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()` 是**唯一使用点**,没有别处缓存。 **修复:** 用成员变量维护计数,插入/删除时增减: ```cpp m_jsonCount++; // insert 成功 m_jsonCount--; // delete 成功 ``` --- ### PF-10 【低】`cleanupUploaded` 引用了不存在的列,函数必然失败 **位置**:`src/app_sq_save.cpp:315-322` ```cpp 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` 已是行删除语义,无需此函数)。 --- ## 五、架构设计评估与建议 ### 5.1 现状架构 ``` ┌─────────────────────────────────────────────────────────┐ │ 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(拼接) │ └────────────────────────────────────────────────────────────┘ ``` ### 5.2 问题一:全局状态 `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 变量**,无原子性/无锁 **改进建议(渐进式,不必一次重构):** ```cpp // 第一步:引入分组结构体 + 线程安全访问器 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` 的私有方法,彻底消除重复追加的隐患。 --- ### 5.3 问题二:`cameramanager.cpp` 职责过载 该文件(2617 行)同时承担: 1. `.rawv` 文件头编解码(`writeRawHeader`/`readRawVideoMeta`) 2. Bayer/YUYV 解码(`decodeRawBufferToBgr`) 3. 异步写盘线程(`RawRecordWriter`) 4. 视频回放播放器(`RawVideoPlayer`) 5. 帧清晰度搜索(`findSharpestFrameIndex`) 6. 融合帧选择(`selectFuseFrames`) 7. 水印绘制(`drawWatermark`) 8. 相机 SDK 回调与 JNI 桥接 **后果:** 修改任一功能都需通读 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`,使格式变更有唯一改动点。 --- ### 5.4 问题三:数据库访问层重复且风格不统一 **现状对比:** | | `SqliteOperator` | `DatabaseInterface` | |---|---|---| | 打开方式 | 构造时 + `OpenDb()` | `ensureDb()` 惰性绑定 | | 返回值 | 一律 `int`,恒为 0 | `bool`,反映真实结果 | | 连接处理 | 依赖调用方 `OpenDb/CloseDb` | 幂等 `ensureConfigDbOpen()` | | 死代码 | `QueryData()`(查不存在的 student 表)、`InertListConfig()`(`INSERT INFO` 拼写错误) | `insertData`/`deleteData`(操作不存在的 Info 表) | **两套并存导致的历史事故**(代码注释中已记录):`DatabaseInterface` 曾从未调用 `openDatabase()`,导致所有 MQTT 远程配置写库失败。 **改进建议:** 以 `DatabaseInterface` 为唯一入口,废弃 `SqliteOperator`: 1. `DatabaseInterface` 增加 `ensureColumnExist()` / `ensureConfigRow()` / `createTable()` 的通用实现 2. 全局替换 `param::table_xxx` 的字符串表名为枚举 3. 删除死代码:`SqliteOperator::QueryData()`、`InertListConfig()`、`DatabaseInterface::insertData()`、`DatabaseInterface::deleteData()` --- ### 5.5 问题四:`main.cpp` 承担过多启动装配职责 **现状:** `main.cpp` 中有 200+ 行是数据库初始化与信号连接,实际"启动一个应用"的内容不足 50 行。且 `setupEth1()` 这类**可能阻塞 50 秒**的操作被同步放在 `app.exec()` 之前。 **改进建议:** 引入 `AppBootstrap` 类,把启动流程显式化: ```cpp class AppBootstrap { public: void loadConfig(); // 数据库初始化(QTimer::singleShot(0) 延迟) void configureNetwork(); // setupEth1 移到独立线程 void wireSignals(); // 所有 connect 集中 void exposeToQml(); // setContextProperty 集中 }; ``` 收益:启动流程一眼可读,测试时可单独调用各阶段;`main()` 回归到 20 行以内。 --- ### 5.6 问题五:缺少统一的错误处理与日志策略 **现状:** - 日志用 `LOG/WARN/ERROR`(spdlog 封装),但**没有运行时级别控制**——生产环境与调试环境日志量相同 - 错误处理方式不统一:有的返回 `false`,有的返回 `0`(永远成功),有的只打日志 - 无全局异常捕获:`setupEth1()` 抛异常、`std::bad_alloc`(PF-1 的 OOM 场景)都会直接终止进程 **改进建议:** 1. `INITLOG()` 增加 `setLogLevel()`,默认 INFO,Release 构建下 GPS 逐秒日志等降为 DEBUG 2. 关键路径(录制、融合、上传)加 `try/catch` 与 `std::bad_alloc` 捕获,失败降级而非崩溃 3. 统一返回类型约定:`bool` 表示成功与否,`int` 仅用于确有意义的状态码 --- ### 5.7 值得肯定的设计决策 | 决策 | 位置 | 评价 | |---|---|---| | 存 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 PSS` - **耗时**:`m_opencv.cpp` 已有 `TIMER_SCOPE` 埋点(`halcon-focus` / `halcon-argmax` / `halcon-agd` / `halcon-sigmaFuse`),直接读日志即可对比 - **融合质量**:对比修复前后的融合图与最清晰帧的梯度能量(项目注释中记录的历史基线是"细节保持 87%、景深扩展 +43%") > **提醒**:按项目约定,任何代码改动都必须同步升级 5 处版本号(`main.h` / `CMakeLists.txt` / `qml/config.json` / `AndroidManifest.xml` / `docs/Readme.md`),否则设备端无法覆盖安装。本次仅做分析,未改动代码,故未升版本。 --- *报告生成时间:2026-09-28 | 分析者:静态代码审计 | 未修改任何源代码*