基于Java的Chrome扩展Native Messaging Host执行命令报错排查

错误原因 #

你遇到的Error: Native application tried to send a message of 1734439797 bytes错误，本质是Chrome Native Messaging的通信协议被破坏。Native Messaging要求宿主只能通过stdout发送严格格式的消息：先发送4字节小端整数表示JSON消息的长度，再发送JSON内容。一旦有其他无关输出（比如外部命令的输出、Java程序的意外打印）混入stdout，Chrome就会把这些乱码解析成消息长度，从而得到一个异常超大的数值，导致连接中断。

你的ProcessBuilder调用主要有以下潜在问题：

• 输出重定向可能失效：new File("command-output.log")使用相对路径，若Java宿主的工作目录没有写入权限，重定向会失败，外部命令的输出会直接流入stdout，破坏Native Messaging协议。
• 未等待进程执行完成：启动Process后没有调用waitFor()，可能导致后台进程持续占用资源，甚至输出流未完全处理，间接干扰通信通道。
• 未处理异常场景：命令执行失败时没有及时反馈，可能导致连接因超时或未响应中断。

修复后的ProcessBuilder代码 #

private void executeCommand() {
    List<String> builderList = new ArrayList<>();
    builderList.add("cmd.exe");
    builderList.add("/C");
    builderList.add("tasklist | findstr chrome");

    ProcessBuilder processBuilder = new ProcessBuilder(builderList);
    processBuilder.redirectErrorStream(true);
    
    // 使用绝对路径确保文件可写入，避免权限或路径问题
    File logFile = new File(System.getProperty("user.dir") + File.separator + "command-output.log");
    processBuilder.redirectOutput(logFile);

    try {
        Process process = processBuilder.start();
        // 等待命令执行完成，避免后台进程残留
        int exitCode = process.waitFor();
        log("命令执行完成，退出码：" + exitCode);
        
        // 执行成功后给扩展返回响应
        String response = "{\"success\":true,\"message\":\"命令执行完成\"}";
        app.sendMessage(response);
    } catch (IOException | InterruptedException e) {
        log("命令执行失败：" + e.getMessage());
        // 执行失败时返回错误信息
        String errorResponse = "{\"success\":false,\"message\":\"" + e.getMessage() + "\"}";
        try {
            app.sendMessage(errorResponse);
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }
}

关键注意事项 #

• 严格隔离stdout：Java宿主的System.out只能用于发送Native Messaging消息，所有日志、调试信息必须写入文件或使用System.err（stderr的内容会进入Chrome的调试日志，不会影响通信协议）。
• 使用绝对路径：文件操作尽量用绝对路径，避免因工作目录不确定导致的权限或找不到文件问题。
• 及时反馈结果：无论命令执行成功或失败，都要给Chrome扩展返回符合格式的JSON响应，避免连接因未响应中断。

关于本地服务器+异步REST的方案 #

这个方案是完全可行的，甚至比直接用Native Messaging更灵活：

• 可以异步处理命令执行，避免Native Messaging的同步阻塞问题。
• 扩展通过fetch调用本地HTTP接口，通信方式更直观，不容易出现流协议的问题。
• 本地服务器可以独立于Chrome扩展的生命周期，支持更复杂的后台任务。

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