如何捕获X11 XIO致命错误？Docker中GLFW应用启动异常问题

核心原因 #

你遇到的XIO: fatal IO error 11是X服务器底层连接断开导致的致命错误，这类错误会直接触发Xlib终止进程，而glfwSetErrorCallback和XSetErrorHandler仅能处理非致命的X协议错误（比如参数错误、资源不存在等），完全拦截不到这种级别的致命IO错误，所以你的回调不会被调用。

另外，进程退出码为0是因为Xlib默认用exit(0)终止进程，导致Docker的on-failure重启策略无法触发。

可行解决方案 #

1. 启动前预检查X服务器就绪状态 #

在启动GLFW应用前，先确认宿主机的X服务器完全就绪，避免Docker过早拉起应用。可以在容器的entrypoint脚本中加入循环检测逻辑：

#!/bin/sh
# 循环等待X服务器就绪，直到xdpyinfo能正常获取显示信息
until xdpyinfo -display :0 > /dev/null 2>&1; do
    echo "Waiting for X server :0 to be ready..."
    sleep 1
done
# 启动你的GLFW应用
exec ./your-glfw-application

2. 监控应用启动状态，强制返回非零退出码 #

如果预检查仍有遗漏，可以通过脚本监控应用的运行时长：如果应用在极短时间内（比如5秒）退出且返回码为0，判定为启动失败，手动返回非零码让Docker重启：

#!/bin/sh
wait_for_x() {
    until xdpyinfo -display :0 > /dev/null 2>&1; do
        sleep 1
    done
}

wait_for_x
# 记录启动时间
start_time=$(date +%s)
# 启动应用
./your-glfw-application
exit_code=$?
# 计算运行时长
run_duration=$(( $(date +%s) - start_time ))

# 短时间退出+退出码0，判定为启动失败，返回1
if [ $run_duration -lt 5 ] && [ $exit_code -eq 0 ]; then
    echo "App exited abnormally early, marking as failure"
    exit 1
fi

# 正常退出则返回原码
exit $exit_code

3. 调整容器启动的系统依赖（宿主机层面） #

如果是用systemd管理容器开机启动，配置容器服务依赖graphical.target，确保宿主机X服务器完全启动后再拉起容器：

[Unit]
Description=GLFW Application Container
After=graphical.target

[Service]
Restart=on-failure
ExecStart=/usr/bin/docker run --rm --name glfw-app your-image-name

[Install]
WantedBy=graphical.target

4. 用XSetIOErrorHandler捕获致命XIO错误 #

虽然Xlib会终止进程，但可以通过XSetIOErrorHandler设置自定义处理函数，在进程终止前强制返回非零退出码。注意要在glfwInit()之前设置，避免GLFW覆盖这个处理：

#include <X11/Xlib.h>
#include <stdlib.h>
#include <stdio.h>

// 自定义XIO致命错误处理函数
void xio_fatal_handler(Display* dpy) {
    fprintf(stderr, "Caught XIO fatal error, exiting with code 1\n");
    _exit(1); // 直接调用_exit，绕过标准库清理，确保退出码为1
}

int main() {
    // 先设置XIO错误处理
    XSetIOErrorHandler(xio_fatal_handler);
    
    // 初始化GLFW
    if (!glfwInit()) {
        fprintf(stderr, "GLFW init failed\n");
        return 1;
    }
    
    // 后续应用逻辑...
    // ...
}

这个方法能直接拦截XIO致命错误，强制返回非零退出码，让Docker的on-failure策略生效。

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