Chrome Headless转PDF遇JSESSIONID认证问题求助

问题根源 #

你当前使用--header参数传递Cookie的格式有误，Chrome会将参数中的引号解析为Header内容的一部分，导致Cookie无法被服务器正确识别；另外，Chrome的用户目录缓存、Cookie的路径/域名匹配也可能是认证失败的原因。

具体修复步骤 #

1. 修正--header参数格式 #

移除--header参数内部的引号，因为ProcessBuilder会自动处理参数分隔，不需要额外包裹引号。修改后的参数如下：

ProcessBuilder pb = new ProcessBuilder(
    "/usr/bin/google-chrome",
    "--headless",
    "--disable-gpu",
    "--no-sandbox",
    "--disable-software-rasterizer",
    "--disable-crash-reporter",
    "--disable-dev-shm-usage",
    "--disable-extensions",
    "--disable-features=TFLiteLanguageDetection",
    "--user-data-dir=/tmp/chrome-profile",
    "--disk-cache-dir=/tmp/chrome-profile/cache",
    "--virtual-time-budget=10000",
    "--window-size=1280x2000",
    "--force-device-scale-factor=1",
    "--disable-features=PaintHolding",
    "--run-all-compositor-stages-before-draw",
    "--print-to-pdf=" + tempPdfFilePath,
    // 修正：去掉引号，直接传递Header内容
    "--header=Cookie: JSESSIONID=" + sessionId,
    "--header=User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
    eformHtmlUrl 
);

2. 确保Cookie的完整性 #

如果服务器要求Cookie包含Path或Domain属性，需要传递完整的Cookie字符串。比如从request中获取完整的Cookie值：

// 替换原有的getSessionCookie方法，获取完整的Cookie字符串
String fullCookie = "";
Cookie[] cookies = request.getCookies();
if (cookies != null) {
    for (Cookie cookie : cookies) {
        if ("JSESSIONID".equals(cookie.getName())) {
            fullCookie = String.format("%s=%s; Path=%s; Domain=%s", 
                cookie.getName(), cookie.getValue(), cookie.getPath(), cookie.getDomain());
            break;
        }
    }
}
// 然后传递完整的Cookie到--header
"--header=Cookie: " + fullCookie,

3. 避免用户目录缓存干扰 #

每次运行Chrome时使用全新的临时用户目录，防止旧会话残留影响认证：

// 创建临时目录
File tempDir = Files.createTempDirectory("chrome-profile").toFile();
// 在ProcessBuilder中使用该目录
"--user-data-dir=" + tempDir.getAbsolutePath(),
// 运行后可以删除临时目录（可选）
tempDir.deleteOnExit();

4. 改用Chrome DevTools Protocol（CDP）更可靠 #

如果--header参数始终无法生效，直接通过CDP控制浏览器设置Cookie，这是更稳定的方案。示例代码（使用cdp4j库）：

import io.cdp4j.Launcher;
import io.cdp4j.Browser;
import io.cdp4j.Page;
import io.cdp4j.dto.cookie.Cookie;
import io.cdp4j.dto.page.PrintOptions;
import java.nio.file.Files;
import java.nio.file.Paths;

// 初始化Chrome浏览器
Launcher launcher = Launcher.create();
Browser browser = launcher.launch();
Page page = browser.newPage();

// 设置完整的Cookie（根据实际域名和路径调整）
page.setCookie(
    Cookie.builder()
        .name("JSESSIONID")
        .value(sessionId)
        .domain("your-server-domain.com") // 替换为你的服务器域名
        .path("/") // 替换为实际的Cookie路径
        .httpOnly(true) // 如果原Cookie是HttpOnly，需要加上
        .secure(false) // 根据是否使用HTTPS调整
        .build()
);

// 导航到目标页面并等待加载完成
page.navigate(eformHtmlUrl);
page.waitForLoad(WaitUntil.NETWORK_IDLE);

// 生成PDF并保存到文件
byte[] pdfBytes = page.print(PrintOptions.create());
Files.write(Paths.get(tempPdfFilePath), pdfBytes);

// 清理资源
page.close();
browser.close();
launcher.close();

5. 验证请求头 #

可以通过后端日志打印请求的Cookie信息，确认Chrome是否正确传递了JSESSIONID；或者使用tcpdump抓包查看Chrome发送的HTTP请求头，排查参数是否正确。

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