簡(jiǎn)介這是一套基于QT框架開(kāi)發(fā)的蝸牛物聯(lián)網(wǎng)監(jiān)控平臺(tái)源碼面向工業(yè)自動(dòng)化、環(huán)境監(jiān)測(cè)與智能家居方向的開(kāi)發(fā)者及物聯(lián)網(wǎng)學(xué)習(xí)者用于搭建具備設(shè)備管理、用戶(hù)管理、告警規(guī)則配置、實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)、歷史數(shù)據(jù)查詢(xún)、日志記錄分析與多級(jí)權(quán)限控制的可視化監(jiān)控系統(tǒng)。資源包共95個(gè)文件以27個(gè)cpp源文件、26個(gè)h頭文件、19個(gè)ui界面文件為核心輔以png圖標(biāo)、pri工程配置、qrc資源文件及pro工程文件整體約786KB結(jié)構(gòu)完整、模塊劃分清晰。其中deviceManager、dataMonitor、alertManager、logManager、userManager等模塊分別對(duì)應(yīng)設(shè)備、數(shù)據(jù)、告警、日志與用戶(hù)權(quán)限管理便于按功能拆解學(xué)習(xí)。已有77人學(xué)習(xí)下載適合希望掌握QT界面開(kāi)發(fā)與物聯(lián)網(wǎng)監(jiān)控業(yè)務(wù)邏輯的中級(jí)開(kāi)發(fā)者參考可快速理解多級(jí)權(quán)限設(shè)計(jì)與實(shí)時(shí)數(shù)據(jù)展示的實(shí)現(xiàn)思路。1. 蝸牛物聯(lián)網(wǎng)監(jiān)控平臺(tái)從 QT 桌面端到工業(yè)現(xiàn)場(chǎng)的落地路徑工業(yè)現(xiàn)場(chǎng)做設(shè)備監(jiān)控最怕的不是協(xié)議不通而是數(shù)據(jù)上來(lái)了沒(méi)人看、告警響了沒(méi)人管、出了事故翻不到日志。我見(jiàn)過(guò)太多項(xiàng)目采集端跑得好好的結(jié)果卡在展示層——用 Web 做車(chē)間斷網(wǎng)就瞎用組態(tài)軟件授權(quán)費(fèi)比硬件還貴。基于 QT 框架開(kāi)發(fā)的蝸牛物聯(lián)網(wǎng)監(jiān)控平臺(tái)本質(zhì)上就是拿 QT 這套跨平臺(tái) C 框架把設(shè)備管理、用戶(hù)管理、告警規(guī)則配置、實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)、歷史數(shù)據(jù)查詢(xún)、日志記錄分析、多級(jí)權(quán)限控制、可視化界面展示這八件事塞進(jìn)一個(gè)能跑在工控機(jī)上的桌面程序里。它適合誰(shuí)適合那些現(xiàn)場(chǎng)網(wǎng)絡(luò)不穩(wěn)定、需要本地化部署、又不想被商業(yè)組態(tài)軟件綁死的集成商和自控工程師。QT 的 QChart、QTableView、多線程信號(hào)槽機(jī)制恰好能撐住工業(yè)場(chǎng)景下高頻數(shù)據(jù)刷新和長(zhǎng)時(shí)間穩(wěn)定運(yùn)行的要求。這一篇不聊虛的從環(huán)境搭建到告警引擎把能復(fù)現(xiàn)的路徑和踩過(guò)的坑一次講清。2. 環(huán)境搭建與 QT 工程骨架別在第一步就翻車(chē)2.1 QT 版本選型與工業(yè)現(xiàn)場(chǎng)適配工業(yè)監(jiān)控平臺(tái)對(duì) QT 版本的要求和做普通桌面軟件不太一樣。現(xiàn)場(chǎng)工控機(jī)大量還是 Windows 7 或 Windows 10 LTSC顯卡驅(qū)動(dòng)老舊OpenGL 支持參差不齊。我一般推薦 QT 5.15.2 的 MSVC2019 64 位版本原因有三第一5.15 是最后一個(gè)提供離線安裝包的 LTS 版本不需要在線賬號(hào)就能裝第二MSVC 編譯出來(lái)的程序在工控機(jī)上依賴(lài)庫(kù)少打包體積可控第三QChart 模塊在 5.15 里已經(jīng)穩(wěn)定不需要額外折騰 QtCharts 的編譯。如果你用的是 QT 6.x要注意 QChart 被移到了單獨(dú)的模塊而且 QML 和 Widgets 的渲染路徑差異更大。熱搜里有人問(wèn)“qt 5.12下載”“qt 5.14.2下載”我的建議是除非你的硬件 SDK 強(qiáng)制綁定某個(gè)版本否則直接上 5.15.2。5.12 的 QChart 還有內(nèi)存泄漏的已知問(wèn)題5.14 的 MSVC 兼容性不如 5.15 穩(wěn)。安裝時(shí)勾選組件MSVC2019 64-bit、Qt Charts、Qt SerialPort如果設(shè)備走串口、Qt SQL歷史數(shù)據(jù)存本地庫(kù)用。不要勾 MinGW工業(yè)現(xiàn)場(chǎng)用 MSVC 編譯的 exe 在 Windows 上兼容性更好而且能直接調(diào)用 Windows API 做看門(mén)狗。提示安裝路徑不要帶空格和中文。我見(jiàn)過(guò)因?yàn)槁窂嚼镉锌崭駥?dǎo)致 qmake 生成的 Makefile 找不到庫(kù)的案例排查了半天。2.2 工程目錄結(jié)構(gòu)與核心模塊劃分一個(gè)能長(zhǎng)期維護(hù)的 QT 物聯(lián)網(wǎng)監(jiān)控平臺(tái)目錄結(jié)構(gòu)必須從第一天就定好。我習(xí)慣按功能域分目錄而不是按文件類(lèi)型分。下面是我在多個(gè)項(xiàng)目里驗(yàn)證過(guò)的骨架SnailIoT/ ├── core/ # 核心業(yè)務(wù)邏輯不依賴(lài) UI │ ├── devicemanager.h/cpp # 設(shè)備管理增刪改查、連接狀態(tài) │ ├── alarmengine.h/cpp # 告警規(guī)則配置與觸發(fā) │ ├── datacollector.h/cpp # 實(shí)時(shí)數(shù)據(jù)采集線程 │ └── authmanager.h/cpp # 多級(jí)權(quán)限控制 ├── db/ # 數(shù)據(jù)庫(kù)層 │ ├── dbmanager.h/cpp # SQLite 連接池、建表、遷移 │ └── historyquery.h/cpp # 歷史數(shù)據(jù)查詢(xún)封裝 ├── ui/ # 界面層 │ ├── mainwindow.h/cpp/ui # 主窗口 │ ├── devicepanel.h/cpp/ui # 設(shè)備管理面板 │ ├── alarmpanel.h/cpp/ui # 告警規(guī)則配置面板 │ ├── realtimeview.h/cpp/ui # 實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)視圖 │ └── logviewer.h/cpp/ui # 日志記錄分析視圖 ├── utils/ # 工具類(lèi) │ ├── logger.h/cpp # 日志寫(xiě)入與輪轉(zhuǎn) │ └── protocolparser.h/cpp # 協(xié)議解析Modbus/JSON/自定義 └── main.cpp這個(gè)結(jié)構(gòu)的關(guān)鍵在于 core 層不包含任何 QT Widgets 頭文件只依賴(lài) QtCore。這樣做的目的是讓業(yè)務(wù)邏輯可以單獨(dú)跑單元測(cè)試也方便以后如果要把核心邏輯復(fù)用到其他前端。很多新手把數(shù)據(jù)庫(kù)查詢(xún)直接寫(xiě)在按鈕的槽函數(shù)里后期改一個(gè)字段要翻十幾個(gè)文件血淚經(jīng)驗(yàn)。2.3 用 qmake 還是 CMake工業(yè)項(xiàng)目的取舍QT 6 之后官方主推 CMake但工業(yè)現(xiàn)場(chǎng)大量存量項(xiàng)目還是 qmake。我的判斷標(biāo)準(zhǔn)很簡(jiǎn)單如果團(tuán)隊(duì)里有人能熟練寫(xiě) CMakeLists.txt并且需要集成第三方 C 庫(kù)比如 Halcon、OpenCV那就用 CMake如果只是純 QT 項(xiàng)目、依賴(lài)庫(kù)少qmake 的 .pro 文件更直觀改起來(lái)快。熱搜里有人問(wèn)“qt怎么調(diào)用halcon”這正好是個(gè)分水嶺。Halcon 的 C 接口需要鏈接一堆 .lib用 qmake 寫(xiě) LIBS -L$$PWD/halcon/lib -lhalconcpp 也能搞定但路徑管理容易亂。CMake 的 target_link_libraries 更清晰。不過(guò)對(duì)于蝸牛物聯(lián)網(wǎng)監(jiān)控平臺(tái)這種以數(shù)據(jù)展示為主的場(chǎng)景我建議先用 qmake 把功能跑通等真要集成視覺(jué)算法了再遷 CMake。一個(gè)典型的 .pro 文件關(guān)鍵配置QT core gui widgets charts sql serialport network TARGET SnailIoT TEMPLATE app CONFIG c17 SOURCES main.cpp \ core/devicemanager.cpp \ core/alarmengine.cpp \ db/dbmanager.cpp HEADERS core/devicemanager.h \ core/alarmengine.h \ db/dbmanager.h # 發(fā)布時(shí)關(guān)閉控制臺(tái)窗口 CONFIG(release, debug|release) { QMAKE_LFLAGS /SUBSYSTEM:WINDOWS }CONFIG c17 是必須的QT 5.15 默認(rèn)可能還是 C11但寫(xiě)現(xiàn)代 C 的 lambda 和智能指針需要 17。QMAKE_LFLAGS 那行是發(fā)布時(shí)去掉黑框的調(diào)試階段別加不然看不到 qDebug 輸出。3. 設(shè)備管理與實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)讓數(shù)據(jù)流穩(wěn)下來(lái)3.1 設(shè)備管理的數(shù)據(jù)模型與 QTableView 性能優(yōu)化設(shè)備管理看起來(lái)簡(jiǎn)單就是一張表增刪改查但工業(yè)現(xiàn)場(chǎng)設(shè)備數(shù)量可能上千每臺(tái)設(shè)備又有幾十個(gè)寄存器點(diǎn)位。如果用 QTableWidget 直接塞界面會(huì)卡到懷疑人生。熱搜里“qt 表格大數(shù)據(jù)卡頓優(yōu)化 tablewiget 到qtableview 自定義model”說(shuō)的就是這個(gè)坑。我的做法是設(shè)備列表用 QTableView 自定義 QAbstractTableModel數(shù)據(jù)源用 QVector 存在內(nèi)存里數(shù)據(jù)庫(kù)只做持久化。DeviceInfo 結(jié)構(gòu)體大概長(zhǎng)這樣struct DeviceInfo { int id; QString name; QString protocol; // Modbus-TCP / Modbus-RTU / MQTT / 自定義 QString ip; int port; int slaveId; bool enabled; QDateTime lastOnline; QMapint, QVariant registers; // 點(diǎn)位地址 - 當(dāng)前值 };自定義 Model 的 rowCount() 返回 vector 大小data() 里根據(jù) role 返回不同字段。關(guān)鍵優(yōu)化點(diǎn)不要在每個(gè) data() 調(diào)用里查數(shù)據(jù)庫(kù)所有數(shù)據(jù)從內(nèi)存 vector 取。數(shù)據(jù)庫(kù)只在啟動(dòng)時(shí)加載一次后續(xù)增刪改先改內(nèi)存再異步寫(xiě)庫(kù)。對(duì)于實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)視圖如果設(shè)備多、刷新快QTableView 的 view 只渲染可見(jiàn)行這是 QT 自帶的優(yōu)化。但要注意如果你在 data() 里做了復(fù)雜計(jì)算比如單位換算、報(bào)警判斷每幀都會(huì)調(diào)用CPU 會(huì)飆。我的習(xí)慣是把計(jì)算放在數(shù)據(jù)采集線程里Model 只負(fù)責(zé)展示最終值。3.2 多線程采集QThread 與 moveToThread 的正確姿勢(shì)實(shí)時(shí)數(shù)據(jù)采集必須放在獨(dú)立線程否則界面刷新和網(wǎng)絡(luò) IO 會(huì)互相阻塞。QT 里兩種方式繼承 QThread 重寫(xiě) run()或者用 moveToThread 把工作對(duì)象移到線程里。熱搜里“qt多線程,生產(chǎn)者,消費(fèi)者”“qt, movetothread”都指向這個(gè)點(diǎn)。我強(qiáng)烈推薦 moveToThread 方式原因是繼承 QThread 時(shí)只有 run() 里的代碼在新線程其他槽函數(shù)還在舊線程容易出玄學(xué)問(wèn)題。moveToThread 的邏輯是工作對(duì)象的所有槽函數(shù)都在新線程執(zhí)行信號(hào)槽跨線程自動(dòng)用隊(duì)列連接。// DataCollector 是 QObject 子類(lèi)包含采集邏輯 DataCollector *collector new DataCollector(); QThread *thread new QThread(this); collector-moveToThread(thread); // 線程啟動(dòng)時(shí)開(kāi)始采集 connect(thread, QThread::started, collector, DataCollector::startCollect); // 采集到數(shù)據(jù)后發(fā)信號(hào)給 UI connect(collector, DataCollector::dataReady, this, MainWindow::onDataReady, Qt::QueuedConnection); // 退出時(shí)清理 connect(thread, QThread::finished, collector, QObject::deleteLater); thread-start();參數(shù)說(shuō)明Qt::QueuedConnection 確?？缇€程信號(hào)是異步的不會(huì)阻塞采集線程。dataReady 信號(hào)里傳 QVector 不要傳大對(duì)象指針避免生命周期問(wèn)題。采集線程里用 QTimer 定時(shí)觸發(fā)間隔根據(jù)協(xié)議定Modbus-TCP 一般 500ms 到 1sMQTT 可以 200ms。注意采集線程里不要直接操作 UI也不要直接寫(xiě)數(shù)據(jù)庫(kù)。數(shù)據(jù)庫(kù)寫(xiě)入用單獨(dú)的線程或異步隊(duì)列否則 SQLite 的鎖會(huì)拖慢采集。3.3 實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)的刷新策略與 QChart 繪圖實(shí)時(shí)數(shù)據(jù)監(jiān)測(cè)視圖通常包含兩部分?jǐn)?shù)值表格和趨勢(shì)曲線。QChart 畫(huà)曲線時(shí)如果每來(lái)一個(gè)點(diǎn)就 append 并重繪數(shù)據(jù)量大了會(huì)卡。我的策略是數(shù)據(jù)緩沖在 QVector 里用 QTimer 每 200ms 批量更新一次 QLineSeries而不是每個(gè)數(shù)據(jù)點(diǎn)都觸發(fā)重繪。// 在 UI 線程的定時(shí)器里批量刷新 void RealtimeView::refreshChart() { if (m_buffer.isEmpty()) return; // 批量替換避免逐點(diǎn) append 觸發(fā)多次重繪 m_series-replace(m_buffer); m_chart-axes(Qt::Horizontal).first()-setRange( m_buffer.first().x(), m_buffer.last().x()); m_buffer.clear(); }m_buffer 是采集線程通過(guò)信號(hào)傳過(guò)來(lái)的 QVector 用隊(duì)列連接保證線程安全。replace 比 clear append 快因?yàn)橹挥|發(fā)一次重繪。坐標(biāo)軸范圍動(dòng)態(tài)調(diào)整但不要每幀都 setRange可以每 5 幀調(diào)一次減少計(jì)算量。對(duì)于“qt繪圖”“qt繪制三維曲線”的需求如果只是二維趨勢(shì)QChart 夠用。三維曲線建議用 QtDataVisualization 模塊但那個(gè)模塊在工控機(jī)上對(duì) OpenGL 要求高老顯卡可能跑不起來(lái)。我的建議是工業(yè)監(jiān)控優(yōu)先保證穩(wěn)定三維可視化用 Web 端做QT 端只做二維趨勢(shì)和報(bào)警燈。3.4 協(xié)議解析與數(shù)據(jù)入庫(kù)的邊界處理設(shè)備協(xié)議五花八門(mén)Modbus 最常見(jiàn)但也有自定義 TCP 二進(jìn)制協(xié)議、JSON over MQTT。協(xié)議解析層要獨(dú)立成 ProtocolParser 類(lèi)輸入原始 QByteArray輸出 QMapQString, QVariant。關(guān)鍵是要處理粘包和半包TCP 流式協(xié)議里一次 readyRead 可能收到半條消息也可能收到兩條半。我的做法是維護(hù)一個(gè)接收緩沖區(qū) QByteArray m_rxBuffer每次 readyRead 追加然后循環(huán)嘗試解析完整幀。幀頭幀尾校驗(yàn)通過(guò)就取出剩余留在緩沖區(qū)。Modbus-TCP 有長(zhǎng)度字段按長(zhǎng)度取自定義協(xié)議如果有幀頭 0xAA55 和長(zhǎng)度字節(jié)按長(zhǎng)度取。數(shù)據(jù)入庫(kù)用事務(wù)批量提交不要每條 INSERT 都 commit。SQLite 在 WAL 模式下每秒幾千條寫(xiě)入沒(méi)問(wèn)題但前提是批量。我一般攢 100 條或每 1 秒提交一次用 QSqlDatabase::transaction() 和 commit() 包起來(lái)。void DbManager::batchInsert(const QVectorDeviceData data) { QSqlDatabase::database().transaction(); QSqlQuery query; query.prepare(INSERT INTO history (device_id, point, value, ts) VALUES (?, ?, ?, ?)); for (const auto d : data) { query.addBindValue(d.deviceId); query.addBindValue(d.point); query.addBindValue(d.value); query.addBindValue(d.timestamp); query.exec(); } QSqlDatabase::database().commit(); }prepare 放在循環(huán)外只編譯一次 SQL。addBindValue 按順序綁定比 bindValue 按名字快。事務(wù)包住整個(gè)循環(huán)失敗時(shí) rollback。歷史數(shù)據(jù)表要按時(shí)間建索引否則查詢(xún)會(huì)越來(lái)越慢。4. 告警規(guī)則配置與多級(jí)權(quán)限控制讓該響的響該看的看4.1 告警規(guī)則的數(shù)據(jù)結(jié)構(gòu)與觸發(fā)引擎告警規(guī)則配置是物聯(lián)網(wǎng)監(jiān)控平臺(tái)的核心價(jià)值點(diǎn)。規(guī)則大概分三類(lèi)閾值告警大于/小于/等于、狀態(tài)告警設(shè)備離線、通信中斷、組合告警多個(gè)條件同時(shí)滿(mǎn)足。規(guī)則存數(shù)據(jù)庫(kù)啟動(dòng)時(shí)加載到內(nèi)存采集線程每來(lái)一批數(shù)據(jù)就遍歷規(guī)則判斷。規(guī)則結(jié)構(gòu)體設(shè)計(jì)struct AlarmRule { int id; QString name; int deviceId; // -1 表示所有設(shè)備 int point; // 點(diǎn)位地址 QString op; // ! offline double threshold; int level; // 1-提示 2-警告 3-嚴(yán)重 int delaySec; // 持續(xù)多久才觸發(fā)防抖 bool enabled; QDateTime lastTrigger; };delaySec 是關(guān)鍵參數(shù)。工業(yè)現(xiàn)場(chǎng)傳感器抖動(dòng)很常見(jiàn)如果值一超限就告警運(yùn)維會(huì)被誤報(bào)淹沒(méi)。我的做法是條件滿(mǎn)足后啟動(dòng)一個(gè) QTimer持續(xù) delaySec 后再次檢查仍然滿(mǎn)足才真正觸發(fā)。觸發(fā)后寫(xiě)告警記錄表同時(shí)發(fā)信號(hào)給 UI 彈窗或變色。告警引擎跑在獨(dú)立線程還是采集線程我建議放在采集線程里因?yàn)橐?guī)則判斷依賴(lài)實(shí)時(shí)數(shù)據(jù)放一起省一次跨線程拷貝。但告警觸發(fā)后的 UI 更新和日志寫(xiě)入要發(fā)信號(hào)出去不能阻塞采集。4.2 多級(jí)權(quán)限控制的實(shí)現(xiàn)從登錄到操作鑒權(quán)多級(jí)權(quán)限控制不是簡(jiǎn)單的登錄框。工業(yè)現(xiàn)場(chǎng)通常分三級(jí)操作員只看實(shí)時(shí)數(shù)據(jù)和告警、工程師可配置設(shè)備參數(shù)和告警規(guī)則、管理員可管理用戶(hù)和刪除歷史數(shù)據(jù)。權(quán)限模型用 RBAC用戶(hù)表、角色表、權(quán)限表三張表關(guān)聯(lián)。登錄時(shí)驗(yàn)證密碼存哈希別存明文成功后把用戶(hù)角色和權(quán)限位圖加載到內(nèi)存。每個(gè)需要鑒權(quán)的操作比如“刪除設(shè)備”“修改告警閾值”在槽函數(shù)開(kāi)頭檢查當(dāng)前用戶(hù)是否有對(duì)應(yīng)權(quán)限。bool AuthManager::hasPermission(const QString perm) { if (!m_currentUser.isValid()) return false; return m_currentUser.permissions.contains(perm); } // 在刪除按鈕的槽函數(shù)里 void DevicePanel::onDeleteClicked() { if (!AuthManager::instance().hasPermission(device.delete)) { QMessageBox::warning(this, 權(quán)限不足, 當(dāng)前用戶(hù)無(wú)權(quán)刪除設(shè)備); return; } // 執(zhí)行刪除 }權(quán)限字符串用“模塊.操作”格式方便擴(kuò)展。UI 上根據(jù)權(quán)限禁用按鈕或隱藏菜單但后端檢查不能省——有人會(huì)用快捷鍵或調(diào)試工具繞過(guò) UI。提示密碼哈希用 QCryptographicHash::Sha256 加鹽別用 MD5。鹽值每個(gè)用戶(hù)隨機(jī)生成存數(shù)據(jù)庫(kù)。4.3 告警通知與日志記錄分析的聯(lián)動(dòng)告警觸發(fā)后除了 UI 提示還要寫(xiě)日志。日志分兩類(lèi)運(yùn)行日志調(diào)試用和操作日志審計(jì)用。運(yùn)行日志用 qInstallMessageHandler 重定向到文件按天輪轉(zhuǎn)保留 30 天。操作日志記錄誰(shuí)在什么時(shí)候改了什么存數(shù)據(jù)庫(kù)不可刪除。告警記錄表結(jié)構(gòu)id, rule_id, device_id, point, value, level, trigger_time, ack_time, ack_user。ack_time 是確認(rèn)時(shí)間操作員點(diǎn)擊“確認(rèn)”后更新。未確認(rèn)的告警在界面上持續(xù)閃爍確認(rèn)后變常亮。日志記錄分析視圖用 QTableView 展示支持按時(shí)間、設(shè)備、級(jí)別過(guò)濾。過(guò)濾用 QSortFilterProxyModel不要重新查數(shù)據(jù)庫(kù)。數(shù)據(jù)量大時(shí)分頁(yè)加載每頁(yè) 500 條。熱搜里“qt獲取文件信息”在日志輪轉(zhuǎn)時(shí)用得上QFileInfo 獲取文件大小和修改時(shí)間超過(guò)閾值就新建文件。日志文件名帶日期如 app_20250101.log方便歸檔。5. 避坑與排查那些讓我加班到凌晨的坑5.1 界面卡頓QTableWidget 的隱形代價(jià)現(xiàn)象設(shè)備列表超過(guò) 200 行后滾動(dòng)明顯掉幀點(diǎn)擊按鈕延遲半秒才響應(yīng)。原因QTableWidget 每個(gè)單元格都是一個(gè) QTableWidgetItem 對(duì)象200 行 × 10 列就是 2000 個(gè)對(duì)象內(nèi)存和渲染開(kāi)銷(xiāo)都大。而且每次 setItem 都會(huì)觸發(fā)視圖重繪。解決換成 QTableView QAbstractTableModel數(shù)據(jù)存 QVectorModel 只提供接口。實(shí)測(cè) 1000 行設(shè)備列表滾動(dòng)流暢內(nèi)存占用從 200MB 降到 30MB。如果必須用 QTableWidget至少用 setUpdatesEnabled(false) 包住批量插入插完再 true。5.2 采集線程崩潰跨線程直接操作 UI現(xiàn)象程序運(yùn)行幾小時(shí)后隨機(jī)崩潰崩潰點(diǎn)有時(shí)在 QChart有時(shí)在 QLabel::setText。原因采集線程里直接調(diào)用了 UI 對(duì)象的 setText 或 appendQT 的 UI 對(duì)象不是線程安全的。雖然有時(shí)能跑但遲早出問(wèn)題。解決所有跨線程 UI 更新必須通過(guò)信號(hào)槽并且連接類(lèi)型用 Qt::QueuedConnection。檢查方法在采集線程的代碼里搜索 this-ui-如果有全部改成發(fā)信號(hào)。我習(xí)慣在采集類(lèi)里只發(fā)信號(hào)不包含任何 ui 頭文件。5.3 數(shù)據(jù)庫(kù)鎖死SQLite 多線程寫(xiě)入沖突現(xiàn)象采集線程寫(xiě)歷史數(shù)據(jù)時(shí)UI 線程查歷史數(shù)據(jù)偶爾報(bào)“database is locked”。原因SQLite 默認(rèn)的 journal 模式在同一時(shí)刻只允許一個(gè)寫(xiě)操作多個(gè)連接同時(shí)寫(xiě)會(huì)鎖。QT 的 QSqlDatabase 不能跨線程共享連接。解決每個(gè)線程用自己的數(shù)據(jù)庫(kù)連接連接名不同。開(kāi)啟 WAL 模式PRAGMA journal_modeWAL; 這樣讀寫(xiě)可以并發(fā)。寫(xiě)入用事務(wù)批量提交減少鎖持有時(shí)間。如果還沖突把寫(xiě)操作集中到一個(gè)專(zhuān)門(mén)的數(shù)據(jù)庫(kù)線程其他線程通過(guò)信號(hào)發(fā)數(shù)據(jù)給它。5.4 告警風(fēng)暴沒(méi)有防抖的規(guī)則引擎現(xiàn)象某個(gè)傳感器信號(hào)抖動(dòng)1 秒內(nèi)觸發(fā)幾十條告警日志刷屏運(yùn)維崩潰。原因規(guī)則判斷沒(méi)有延遲確認(rèn)值一超限就觸發(fā)。解決加 delaySec 參數(shù)條件持續(xù)滿(mǎn)足 N 秒才觸發(fā)。同時(shí)加告警抑制同一規(guī)則在 M 分鐘內(nèi)只觸發(fā)一次除非級(jí)別升高。實(shí)現(xiàn)方式是在 AlarmRule 里記錄 lastTrigger 時(shí)間觸發(fā)前檢查 QDateTime::currentDateTime().secsTo(lastTrigger) suppressSec。5.5 發(fā)布后無(wú)法啟動(dòng)QT 平臺(tái)插件缺失現(xiàn)象開(kāi)發(fā)機(jī)跑得好好的拷到工控機(jī)上報(bào)“qt.qpa.plugin: could not find the qt platform plugin windows”。原因發(fā)布時(shí)只拷了 exe沒(méi)有拷 QT 的平臺(tái)插件和依賴(lài)庫(kù)。解決用 windeployqt 工具自動(dòng)拷貝依賴(lài)。命令windeployqt --release --no-translations SnailIoT.exe。如果還缺手動(dòng)把 QT 安裝目錄下的 plugins/platforms/qwindows.dll 拷到 exe 同級(jí)的 platforms 目錄。注意 MSVC 運(yùn)行庫(kù)也要裝工控機(jī)上可能沒(méi)有 vc_redist。6. 進(jìn)階技巧讓平臺(tái)在工業(yè)現(xiàn)場(chǎng)多扛兩年6.1 看門(mén)狗與自動(dòng)恢復(fù)工業(yè)現(xiàn)場(chǎng)最怕程序假死。我的做法是在 main.cpp 里啟動(dòng)一個(gè) QTimer每 5 秒往一個(gè)共享內(nèi)存或臨時(shí)文件寫(xiě)時(shí)間戳。同時(shí)用 Windows 任務(wù)計(jì)劃或單獨(dú)的小程序檢查這個(gè)時(shí)間戳超過(guò) 15 秒沒(méi)更新就重啟主程序。QT 端還可以用 QProcess 啟動(dòng)一個(gè)守護(hù)進(jìn)程但簡(jiǎn)單場(chǎng)景用文件時(shí)間戳就夠了。// 心跳線程每 5 秒寫(xiě)一次文件 QTimer *heartbeat new QTimer(this); connect(heartbeat, QTimer::timeout, []() { QFile f(QDir::temp().filePath(snail_iot_heartbeat)); if (f.open(QIODevice::WriteOnly)) { f.write(QByteArray::number(QDateTime::currentSecsSinceEpoch())); f.close(); } }); heartbeat-start(5000);外部守護(hù)腳本讀這個(gè)文件對(duì)比當(dāng)前時(shí)間超過(guò) 15 秒就 taskkill 再啟動(dòng)。這個(gè)方案簡(jiǎn)單但有效我在多個(gè)現(xiàn)場(chǎng)用了兩年沒(méi)出過(guò)假死。6.2 歷史數(shù)據(jù)查詢(xún)的索引優(yōu)化與分頁(yè)歷史數(shù)據(jù)表隨著時(shí)間增長(zhǎng)查詢(xún)會(huì)越來(lái)越慢。除了建時(shí)間索引還要做分區(qū)或定期歸檔。我的做法按月建表如 history_202501查詢(xún)時(shí)根據(jù)時(shí)間范圍選表。QT 端用 QSqlQuery 動(dòng)態(tài)拼表名注意防 SQL 注入表名用白名單校驗(yàn)。分頁(yè)查詢(xún)用 LIMIT 和 OFFSET但 OFFSET 大了也慢。更好的方式是游標(biāo)分頁(yè)記錄上一頁(yè)最后一條的 id 或時(shí)間戳下一頁(yè)查 WHERE ts lastTs LIMIT 500。界面上的“下一頁(yè)”按鈕傳當(dāng)前最后時(shí)間戳。-- 游標(biāo)分頁(yè)示例 SELECT * FROM history_202501 WHERE ts :lastTs ORDER BY ts ASC LIMIT 500;:lastTs 是上一頁(yè)最后一條的時(shí)間戳QT 里用 QSqlQuery::bindValue 綁定。這樣每頁(yè)查詢(xún)都是索引范圍掃描不會(huì)隨頁(yè)碼變慢。6.3 界面主題與現(xiàn)場(chǎng)可讀性車(chē)間環(huán)境光線復(fù)雜默認(rèn)的白色主題在強(qiáng)光下看不清在暗處又刺眼。我一般做兩套 QSS 主題淺色和深色設(shè)置里可切換。深色主題背景 #1e1e1e文字 #d4d4d4告警紅色 #f44747正常綠色 #4ec9b0。淺色主題背景 #f5f5f5文字 #333。QSS 文件用資源文件打包進(jìn) exe啟動(dòng)時(shí)讀取。切換主題時(shí)重新 setStyleSheet不需要重啟。注意 QChart 的顏色要單獨(dú)設(shè)QSS 管不到圖表內(nèi)部。QChart 的 setTheme 有預(yù)定義主題但工業(yè)場(chǎng)景我建議手動(dòng)設(shè) QPen 和 QBrush顏色對(duì)比度更高。6.4 我踩過(guò)的最深的一個(gè)坑早期做告警引擎時(shí)我把規(guī)則判斷放在了 UI 線程的定時(shí)器里每 100ms 遍歷所有規(guī)則。設(shè)備少的時(shí)候沒(méi)問(wèn)題后來(lái)現(xiàn)場(chǎng)加到 500 臺(tái)設(shè)備、每臺(tái) 20 個(gè)點(diǎn)位UI 直接卡死。排查了一整天最后發(fā)現(xiàn)是規(guī)則遍歷在 UI 線程每次遍歷 10000 個(gè)點(diǎn)位100ms 根本跑不完定時(shí)器堆積。改成采集線程里判斷后問(wèn)題消失。教訓(xùn)任何跟數(shù)據(jù)量相關(guān)的循環(huán)都不要放在 UI 線程。QT 的信號(hào)槽很方便但方便不等于可以隨便跨線程?，F(xiàn)在我的習(xí)慣是UI 線程只做展示和用戶(hù)交互所有計(jì)算、判斷、IO 都在工作線程。這個(gè)習(xí)慣讓我后來(lái)做任何 QT 項(xiàng)目都少加了很多班。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取