Qt 6.3交叉编译QML应用在Raspberry Pi OS中FileDialog不显示保存按钮问题

我之前在交叉编译Qt嵌入式应用时碰到过几乎一模一样的问题，结合你的环境（Ubuntu22.04交叉编译Qt6.3，运行在RPi400的Raspbian11上），大概率是Qt平台插件适配不完整或者对话框后端未正确启用导致的，下面给你几个排查和解决的方向：

一、先快速验证：强制指定平台和对话框后端 #

这是最快能确认问题的方法，先试试这两步：

1. 启动应用时指定Qt平台 #

Raspbian Bullseye默认可能混用Wayland和X11，Qt6在嵌入式环境下如果自动检测的平台插件有问题，会导致对话框功能缺失。启动应用时加上环境变量强制指定X11平台：

QT_QPA_PLATFORM=xcb ./your_qml_app

如果这样能正常显示文件名输入框和保存按钮，说明是平台插件的自动适配出了问题。

2. 在QML中强制使用原生对话框后端 #

QtQuick Dialogs默认可能会用简化的Qt自身实现，强制指定原生后端可以调用系统的完整对话框：
修改你的QML代码，给FileDialog加上backend属性：

FileDialog{
    id:fdSave
    fileMode:FileDialog.SaveFile
    // 强制使用系统原生对话框
    backend: FileDialog.NativeBackend
}

注意：如果用NativeBackend，需要确保RPi上安装了GTK3依赖库，执行以下命令确认：

sudo apt install libgtk-3-0

二、交叉编译和部署环节的排查 #

如果上面的临时解决方法有效，接下来要从根源上解决，确保交叉编译和部署的完整性：

1. 检查交叉编译Qt时的平台插件配置 #

交叉编译Qt6.3时，必须确保启用了对应RPi平台的插件，比如X11或者Wayland：

• 配置Qt交叉编译时，要加上-qt-xcb（启用X11平台）或者-qt-wayland（启用Wayland平台）参数
• 编译完成后，检查Qt安装目录下的plugins/platforms目录，确认有libqxcb.so（X11）或者libqwayland-egl.so（Wayland）等插件

2. 确保QtQuick Dialogs模块完整编译 #

交叉编译时，要确认Qt Quick Dialogs模块被正确启用：

• 查看Qt交叉编译的配置日志，确认Qt Quick Dialogs的状态是enabled
• 如果配置时没自动启用，可以手动加上-qt-quick-dialogs参数

3. 部署时复制完整的插件文件 #

把应用部署到RPi时，除了应用本身，还要复制对应的Qt插件：

• 复制Qt的平台插件到应用目录下的plugins/platforms（或者指定QT_PLUGIN_PATH环境变量指向插件目录）
• 复制QtQuick Dialogs的插件到plugins/quickdialogs目录

三、总结 #

这个问题的核心是Qt在嵌入式平台上的对话框后端没有正确加载完整功能的实现，先通过指定平台和后端快速验证，再从交叉编译和部署的完整性上彻底解决。

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