wxWidgets程序本地正常却无法在X终端运行，求排查方法

问题背景 #

• 两台部署wxWidgets 3.2.4的主机：
  • Windows 11宿主机上的VirtualBox 7.0.14虚拟机（Fedora 39 guest系统）
  • 原生Fedora 39系统主机
• 虚拟机中的wxWidgets程序可在MobaXterm Personal Edition v24.0的X终端正常显示，但原生主机的同类程序（包括minimal示例、wxglade、wxGlade"bare bones"示例等）无法在该X终端运行，仅能在本地显示器正常显示
• 原生主机连接X终端时程序直接终止，无窗口弹出也无错误信息；绕过SSH隧道时MobaXterm会弹出应用访问授权对话框，但仍无窗口显示
• 已通过strace跟踪程序未获得有效信息，希望通过调整环境变量排查问题，避免编译wxWidgets调试

环境变量排查方法 #

1. 启用X11调试输出 #

通过wxWidgets专属环境变量输出X11初始化细节，定位连接失败点：

export GDK_BACKEND=x11
export WX_DEBUG=1
export WXTRACE="x11"

执行以上命令后再运行目标程序，终端会打印详细的X11交互日志，可从中找到程序终止的具体原因。

2. 验证X11授权配置 #

确保X授权文件路径正确，避免权限验证失败：

# 查看当前XAUTHORITY变量值
echo $XAUTHORITY
# 若未设置，手动指定（替换为你的用户目录下的实际路径）
export XAUTHORITY=/home/your-username/.Xauthority

临时关闭X授权验证排查（仅用于测试，测试后恢复xhost -）：

xhost +

若此时程序能正常显示，说明是X授权配置问题，需调整MobaXterm的X11授权设置或本地XAUTHORITY路径。

3. 强制指定X11显示参数 #

明确指定DISPLAY地址并调整DPI设置，适配MobaXterm的X终端：

# DISPLAY值需与MobaXterm终端中显示的一致（执行echo $DISPLAY获取）
export DISPLAY=localhost:0.0
export GDK_SCALE=1
export GDK_DPI_SCALE=1

4. 禁用Wayland影响 #

Fedora 39默认可能启用Wayland会话，清空相关变量强制程序使用X11后端：

export WAYLAND_DISPLAY=

5. 强制wxWidgets使用X11后端 #

通过变量指定wxWidgets仅使用X11，避免自动后端检测错误：

export WXUSEX11=1

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