Qt调用QFileDialog::getOpenFileName遇乱码及路径获取失败求助

问题现象 #

• 调用QFileDialog::getOpenFileName无法正确获取文件路径
• 尝试转换为GB2312编码缓冲区后，中文路径仍无法正常处理
• 每次调用该函数，输出窗口会出现大量系统组件相关的乱码错误日志

相关代码 #

#include<QFileDialog>
#include<QTextCodec>

void MainDialog::slot_uploadFile(bool flag)
{
    qDebug()<<__func__;
    //弹出窗口 选择文件
    QString path=QFileDialog::getOpenFileName(this,"选择文件","./");
    QTextCodec *code=QTextCodec::codecForName("GB2312");
    std::string pathName=code->fromUnicode(path).data();
    if(path.isEmpty()) return ;
    //发送信号
    QString dir=ui->lb_path->text();
    //发送信号 核心类处理 传递的信息：上传到什么文件到 什么目录下
    qDebug()<<dir;
    Q_EMIT SIG_uploadfile(QString::fromStdString(pathName),dir);
}

错误输出分析 #

• onecoreuap\internal\shell\inc\private\SharedStorageSources\dvthumbnail.cpp(2295)\SHELL32.dll!7541A940：指向Shell功能相关代码位置
• (caller: 765B54BF) ReturnHr(1) tid(51b4) 8002801D：HRESULT错误8002801D，通常与注册表操作异常相关
• ��û��ע�ᡣ及其他乱码：字符编码解析错误导致
• mincore\com\oleaut32\dispatch\ups.cpp(2126)\OLEAUT32.dll!765B2D27：COM组件调度错误
• (caller: 622B81B9) LogHr(1) tid(34cc) C0000034：错误代码C0000034，关联系统或驱动级错误

这些错误多为系统组件层面的日志，核心问题还是Qt代码中编码处理不当导致的路径获取异常。

Qt层面解决方案 #

1. 移除冗余编码转换，直接使用QString #

Qt的QString原生支持Unicode编码，完全兼容中文路径，无需手动转换为GB2312。修改代码如下：

#include<QFileDialog>

void MainDialog::slot_uploadFile(bool flag)
{
    qDebug()<<__func__;
    QString path = QFileDialog::getOpenFileName(this, "选择文件", "./");
    if(path.isEmpty()) return ;
    
    QString dir = ui->lb_path->text();
    qDebug()<<dir;
    Q_EMIT SIG_uploadfile(path, dir); // 直接传递QString对象
}

2. 确认项目编码设置 #

确保项目使用UTF-8编码（Qt官方推荐），在.pro文件中添加：

CODECFORSRC = UTF-8
CODECFORTR = UTF-8

3. 改用QFileDialog实例化方式调用 #

若静态函数存在兼容性问题，可尝试使用非静态实例：

void MainDialog::slot_uploadFile(bool flag)
{
    qDebug()<<__func__;
    QFileDialog dialog(this, "选择文件", "./");
    dialog.setFileMode(QFileDialog::ExistingFile);
    
    if(dialog.exec() == QDialog::Accepted) {
        QString path = dialog.selectedFiles().first();
        if(path.isEmpty()) return ;
        
        QString dir = ui->lb_path->text();
        qDebug()<<dir;
        Q_EMIT SIG_uploadfile(path, dir);
    }
}

4. 过滤系统级错误日志 #

输出窗口的乱码日志来自系统组件，可通过自定义日志处理器过滤：

#include <QApplication>
#include <QDebug>
#include "MainDialog.h"

void customMessageHandler(QtMsgType type, const QMessageLogContext &context, const QString &msg)
{
    // 仅保留Qt自身的调试信息，过滤系统组件日志
    if(type == QtDebugMsg) {
        qDebug() << msg;
    }
}

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    qInstallMessageHandler(customMessageHandler);
    
    MainDialog w;
    w.show();
    return a.exec();
}

内容的提问来源于stack exchange，提问作者xiaocaitao