Armbian系统下OrangePi Lite开机无法启动Tkinter应用求助

问题根源分析 #

脚本手动运行正常但开机自启时Tkinter不启动，核心原因有两个：

1. 图形环境变量缺失：开机自启阶段未正确传递DISPLAY和XAUTHORITY变量，Tkinter依赖这些变量连接当前用户的图形会话
2. sudo权限冲突：root用户无法访问普通用户的图形会话权限，用sudo运行Python脚本会导致图形连接失败

具体解决方案 #

1. 修正启动脚本（startup.sh）

移除sudo，添加图形环境变量，确保Python路径为绝对路径：

#!/bin/bash
# 切换到脚本所在目录
cd /folder-to-main-script
# 导出图形会话必需的环境变量
export DISPLAY=:0
export XAUTHORITY=$HOME/.Xauthority
# 用绝对路径运行Python脚本
/usr/bin/python3 PinReader.py

# 测试用：追加日志到文件，方便排查
echo "$(date) - 脚本执行，DISPLAY=$DISPLAY" >> startup_log.txt

2. 调整.desktop文件配置

将文件放到用户级自启目录~/.config/autostart/（而非系统级的/etc/xdg/autostart/），避免权限问题，同时补充必要参数：

[Desktop Entry]
Name=MyAppName
Exec=bash /full/path/to/working/directory/startup.sh
Type=Application
Version=1.0
# 不需要终端窗口
Terminal=false
# 启用自启标记
X-GNOME-Autostart-enabled=true
Hidden=false
NoDisplay=false
Comment=开机启动Tkinter引脚读取应用

3. 确保脚本权限

给启动脚本添加可执行权限：

chmod +x /full/path/to/working/directory/startup.sh

4. 可选：直接在.desktop中运行Python脚本

如果不需要中间shell脚本，可简化配置，直接指定Python命令和工作目录：

[Desktop Entry]
Name=MyAppName
Exec=/usr/bin/python3 /folder-to-main-script/PinReader.py
Type=Application
Version=1.0
Terminal=false
X-GNOME-Autostart-enabled=true
# 指定脚本工作目录
WorkingDirectory=/folder-to-main-script

排查验证 #

如果仍未启动，可查看日志定位问题：

# 查看用户会话日志
journalctl -u user@$(id -u).service | grep PinReader
# 查看X会话错误日志
cat ~/.xsession-errors | grep -i tkinter

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