Qt 獲取文件信息後崩潰：段錯誤與空指針排查

Qt 媒體播放器項目中，添加文件點擊確定後程序崩潰，調試提示段錯誤（Segmentation Fault）。本文分析常見原因與排查方法。

現象

• 調用 QFileDialog::getOpenFileNames() 或類似靜態方法
• 用戶選擇文件點擊「確定」
程序立即崩潰，無堆棧信息或提示「Segmentation fault」

核心原因

段錯誤 = 訪問非法內存，Qt 文件對話框相關崩潰 90% 由以下原因導致：

1. 空指針解引用：未檢查返回值為空直接使用
2. 跨線程操作 UI：非主線程調用文件對話框或操作 UI 控件
3. 對象生命周期錯誤：臨時對象提前析構，指針懸空
4. 信號槽連接參數類型不匹配：導致調用時棧損壞

排查步驟

1. 啟用調試模式運行：Qt Creator → Debug 模式，崩潰時自動斷點定位到出錯行
2. 檢查返回值：

   QStringList files = QFileDialog::getOpenFileNames(this, "選擇媒體", "", "媒體文件 (*.mp4 *.mp3)");
   if (files.isEmpty()) return; // 用戶取消
   // 後續處理 files...

3. 確保主線程調用：文件對話框必須在 GUI 線程，若在工作線程需用 QMetaObject::invokeMethod 或信號槽切回主線程
4. 使用 AddressSanitizer (ASan)：QMAKE_CXXFLAGS += -fsanitize=address 編譯，能精準定位越界/釋放後使用

常見錯誤代碼模式

// ❌ 錯誤：未判空直接取第一個
QString file = QFileDialog::getOpenFileName(this, "選擇");
ui->label->setText(file); // 用戶取消時 file 為空，某些操作可能崩潰

// ✅ 正確
QString file = QFileDialog::getOpenFileName(this, "選擇");
if (!file.isEmpty()) {
  ui->label->setText(file);
  player->setMedia(QUrl::fromLocalFile(file));
}

總結

Qt 崩潰多為指針/線程/生命周期問題，善用調試器斷點 + ASan，能快速定位 99% 段錯誤根因。