Java调用wkhtmltopdf转PDF报错：系统找不到指定文件

解决方法 #

1. 用完整路径指定wkhtmltopdf #

把命令里的wkhtmltopdf换成它的实际安装路径，比如默认安装路径是C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe，修改后的Java代码：

String command = "\"C:\\Program Files\\wkhtmltopdf\\bin\\wkhtmltopdf.exe\" --enable-local-file-access D://Test//1.html D://Test//output.pdf";

注意：如果路径包含空格，必须给整个路径加上双引号，避免命令拆分出错

2. 检查并生效环境变量 #

确认wkhtmltopdf的bin目录已经添加到系统PATH环境变量里，之后重启你的IDE或者命令行窗口，让新的环境变量生效。这样Java进程就能通过命令名找到可执行文件了。

3. 改用ProcessBuilder执行命令（更稳定） #

Runtime.exec在处理带参数的命令时容易出问题，推荐用ProcessBuilder拆分参数，避免字符串解析错误：

public static void makeAPdf() throws InterruptedException, IOException {
    ProcessBuilder pb = new ProcessBuilder(
        "wkhtmltopdf",
        "--enable-local-file-access",
        "D://Test//1.html",
        "D://Test//output.pdf"
    );
    Process wkhtml = pb.start();
    IOUtils.copy(wkhtml.getErrorStream(), System.err);
    wkhtml.waitFor();
}

如果还是找不到，同样把第一个参数换成完整路径即可。

问题根源 #

• Java进程的环境变量可能和你手动打开的CMD不一样，尤其是IDE以管理员身份运行时，不会继承当前用户的完整PATH，导致找不到wkhtmltopdf命令。
• 直接用命令名调用时，系统需要在PATH中匹配可执行文件，而Java进程的PATH可能没包含wkhtmltopdf的安装目录。

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