树莓派4上Kivy无法打开窗口：指定SDL2却提示缺少X11服务器

核心问题分析 #

日志显示Kivy已选择sdl2窗口后端，但仍出现Unable to connect to X server，本质是SDL2在树莓派Bullseye环境下仍依赖X11显示服务，可能是DISPLAY环境变量未正确设置、默认显示后端（如Wayland）兼容问题，或依赖缺失导致。

分步解决方案 #

1. 确认并设置DISPLAY环境变量 #

在桌面终端执行以下命令：

echo $DISPLAY

• 若输出为空或非:0，手动设置后再运行Kivy程序：

  export DISPLAY=:0
  python your_kivy_app.py
  

2. 强制指定Kivy使用SDL2后端 #

运行程序时通过环境变量明确指定窗口后端：

KIVY_WINDOW=sdl2 python your_kivy_app.py

或在代码开头添加：

import os
os.environ['KIVY_WINDOW'] = 'sdl2'

3. 切换回Xorg显示服务（若默认用Wayland） #

树莓派Bullseye部分版本默认启用Wayland，SDL2对Wayland的支持存在兼容问题：

1. 打开终端执行sudo raspi-config
2. 进入Advanced Options -> Wayland
3. 选择X11作为默认显示服务器
4. 重启树莓派

4. 补全SDL2与Kivy系统依赖 #

确保安装所有必要的底层依赖：

sudo apt-get update
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libgles2-mesa-dev python3-pip

5. 使用虚拟环境隔离安装Kivy #

避免系统包冲突，用虚拟环境重新安装Kivy：

# 创建虚拟环境
python3 -m venv kivy_env
# 激活虚拟环境
source kivy_env/bin/activate
# 更新pip和依赖
pip install --upgrade pip setuptools
# 安装完整版Kivy
pip install kivy[full]

额外说明 #

SDL2在Linux平台支持多显示后端，但树莓派Bullseye的预编译SDL2包默认优先依赖X11。即使选择SDL2作为Kivy窗口后端，仍需确保X11服务正常运行且DISPLAY变量正确指向当前桌面会话。

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