CodeAuditReport.md 43 KB

q6_felgo_iot 代码分析报告

项目:植物病菌孢子捕捉分析系统(Android arm64 工控机) 版本:2.8.16(versionCode 95) 分析范围:src/(18 个 cpp,~9500 行)、header/(22 个头文件)、CMakeLists.txt、android/AndroidManifest.xml 分析日期:2026-09-28 方法:静态代码审查(未修改任何代码)


目录


一、总体评估

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

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;
}

三个叠加缺陷:

  1. byte 未初始化,getChar() 失败(超时、无数据)时仍返回栈上的垃圾值。
  2. getChar() 的 bool 返回值被丢弃,无法区分"读到一个字节"和"读取失败"。
  3. 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;
}

P0-2 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 成功"这个静默失败暴露出来。


P0-3 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; }

P0-4 AndroidManifest.xml 版本属性重复声明,当前值被后面的空值覆盖

位置:android/AndroidManifest.xml:2

<manifest package="com.yfkj.cb.Q6iot" ... android:versionCode="95" android:versionName="2.8.16">
    android:versionCode=&quot;0&quot; android:versionName=&quot;0&quot;&gt;

同一个 <manifest> 标签上,versionCode/versionName 被声明了两次,第二次的值是字面量 0(实体转义后)。XML 解析器对重复属性的处理行为不确定——部分解析器取第一个(95/2.8.16),部分取最后一个(0/0)。

若某些工具链取最后一个值,打包出的 APK 版本号为 0,将导致:

  • Android 认为版本未升级,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">

P0-5 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 开头调用。


三、安全漏洞

S-1 【高】FTP/MQTT 账号密码明文硬编码

位置: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",...};

问题:

  • 设备生产口令、平台 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

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:

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

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

<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,属于无谓的对外暴露,任何应用都可显式启动它。

修复:

  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

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

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 或运行时日志级别开关),仅在定位成功/变化超过阈值时记录。


S-7 【低】main.cpp 中遗留的 License Key 与调试代码

位置:src/main.cpp:467

//felgo.setLicenseKey("234DA84CB6ECABBD8C7E18E7E87DA410005A79E2D05B5C0C81EF353D6A49D3224B...");  // ← 被注释但仍在文件中

注释不是保护。密钥已在版本库历史中,应视为已泄露。

修复: 删除该注释行,并轮换 License Key。


四、性能优化

PF-1 【高】融合权重归一化对 N 张图做 N 次全图 divide

位置: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 时:

  • 全部分配完成需要 400MB 权重 Mat 同时驻留内存
  • 加上 20 张 5MP BGR 原图(约 300MB),峰值内存逼近 700MB

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 风险基本消除。收益:高。


PF-2 【高】argmax 内层循环重复调用 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 比较。当前手写循环已够用,不建议过度设计。


PF-3 【中】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。收益:中。


PF-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 的高斯平滑,尺度信息损失不大。

优化方案(保持算法效果不变的前提下):

  1. 把多尺度计算搬到降采样空间。与权重平滑(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 分辨率的空间频率信息已足够(细节保持率的实测数据表明权重本身是低频的)。

  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

{
    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);

PF-7 【中】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());

PF-8 【低】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;
}

问题:

  1. libcurl 在传输过程中持续回调,5MB 图在慢速 FTP 上可能每秒触发数十次 → 信号风暴,QML 端绑定更新无节流。
  2. remainingTime 是死代码,sglProgress 信号声明了但从不发射。
  3. 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 可中止传输
}

PF-9 【低】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 成功

PF-10 【低】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 已是行删除语义,无需此函数)。


五、架构设计评估与建议

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 变量,无原子性/无锁

改进建议(渐进式,不必一次重构):

// 第一步:引入分组结构体 + 线程安全访问器
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 类,把启动流程显式化:

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 | 分析者:静态代码审计 | 未修改任何源代码