树莓派4自定义服务运行Java图像程序遇X11 DISPLAY错误求助

在树莓派4上开发基于Java和JFrame的循环图像显示程序时，手动执行编译运行脚本完全正常，但通过自定义systemd服务开机启动时出现报错：

No X11 DISPLAY variable was set, but this program performed an operation which requires it.

尝试在脚本中添加export DISPLAY=:0.0后，又出现新错误：

Exception in thread "main" java.awt.AWTError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.

以下是你提供的现有配置：

现有配置 #

systemd服务文件 #

[Unit]
Description=myservice custom script

[Service]
RequiresMountsFor=/media/pi/PICS
ExecStart=+/bin/bash /home/pi/Desktop/PicScript.sh
Restart=always

[Install]
WantedBy=multi-user.target

运行脚本 #

javac /media/pi/PICS/App/App.java
export DISPLAY=:0.0
java -classpath /media/pi/PICS/App App 

问题原因与解决方法 #

1. 为什么需要连接X11窗口服务器 #

JFrame是Java的GUI组件，必须依赖X11窗口系统渲染界面。手动运行时你处于桌面会话中，X11环境已加载，DISPLAY变量自动设置；但systemd服务默认运行在无图形的多用户环境，没有X11会话，因此无法找到窗口服务器。

2. 修改systemd服务配置 #

让服务在X11会话启动后运行，并使用桌面用户的权限和环境：

[Unit]
Description=myservice custom script
After=graphical.target  # 等待图形界面完全启动

[Service]
RequiresMountsFor=/media/pi/PICS
User=pi  # 使用桌面用户pi运行，避免权限冲突
Environment=DISPLAY=:0  # 直接在服务中设置DISPLAY变量
ExecStart=/bin/bash /home/pi/Desktop/PicScript.sh
Restart=always

[Install]
WantedBy=graphical.target  # 随图形会话启动，替换原multi-user.target

3. 简化运行脚本 #

去掉脚本中的export DISPLAY=:0.0，因为服务配置已设置环境变量：

javac /media/pi/PICS/App/App.java
java -classpath /media/pi/PICS/App App 

4. 生效与验证 #

• 重新加载systemd配置并启用服务：

  sudo systemctl daemon-reload
  sudo systemctl enable myservice.service
  

• 测试服务启动：

  sudo systemctl start myservice.service
  

• 查看状态或日志排查问题：

  sudo systemctl status myservice.service
  journalctl -u myservice.service -f
  

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