解决树莓派Chilipie-Kiosk中Java调用Chromium的$DISPLAY缺失问题

问题根源 #

ssh命令行能正常执行切换命令，但Java程序报错找不到DISPLAY，核心原因是Java进程没有继承到正确的DISPLAY环境变量——交互式shell会自动加载全局环境配置，但Java程序如果是非交互式启动（比如后台服务、定时任务），可能不会读取/etc/environment这类全局配置，导致无法定位X服务器。

解决方案 #

方案1：在Java代码中显式指定DISPLAY环境变量

执行Chromium命令前，通过ProcessBuilder手动注入DISPLAY变量，确保进程能找到X会话：

import java.io.IOException;
import java.util.Map;

public class ChromiumSwitcher {
    public static void main(String[] args) throws IOException {
        // 构造Chromium切换页面的命令（根据实际需求调整参数）
        ProcessBuilder pb = new ProcessBuilder("chromium-browser", "--new-window", "https://google.es");
        // 获取进程环境变量并添加DISPLAY配置
        Map<String, String> env = pb.environment();
        env.put("DISPLAY", ":0");
        // 启动进程
        Process process = pb.start();
    }
}

方案2：启动Java程序时传入DISPLAY参数

如果Java程序通过ssh或脚本启动，直接在启动命令前指定DISPLAY：

DISPLAY=:0 java -jar your-chromium-switcher.jar

方案3：使用Chromium远程调试接口（更推荐）

避免重新启动Chromium，直接通过远程调试控制已运行的实例：

1. 修改.xsession配置，启动Chromium时添加远程调试端口：

chromium-browser --kiosk --remote-debugging-port=9222 http://localhost/your-local-page

2. 用Java发送HTTP请求切换页面：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;

public class ChromiumRemoteControl {
    public static void main(String[] args) throws IOException, InterruptedException {
        HttpClient client = HttpClient.newHttpClient();
        // 请求远程调试接口打开目标页面
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("http://localhost:9222/json/new?https://google.es"))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        // 可选：打印响应确认操作结果
        System.out.println(response.body());
    }
}

这种方式完全不需要处理DISPLAY问题，因为是直接控制已在X会话中运行的Chromium实例。

方案4：检查Java进程的运行用户

确保Java程序和Chromium以同一个用户（pi）运行，避免X权限问题。如果是通过systemd等服务启动Java程序，在服务配置中指定User=pi。

内容的提问来源于stack exchange，提问作者Jorge Palacios Zaratiegui