如何搭建Spring Boot应用连接Playwright Docker远程环境？

首先明确：Playwright没有类似Selenium Grid的官方远程网格服务，但可以通过以下两种方式实现你期望的SpringBoot-App → Playwright-Docker → Website架构：

方案一：基于Playwright Server的远程调用 #

Playwright提供了HTTP Server模式，可通过远程API控制浏览器，这是官方支持的远程交互方式：

1. 启动Playwright Server容器 #

使用官方Playwright镜像启动Server（以Node.js版本为例，兼容性更好）：

docker run -d -p 3000:3000 --shm-size=1g mcr.microsoft.com/playwright:v1.40.0-jammy \
  /bin/bash -c "npm install -g playwright@1.40.0 && playwright install chromium && playwright server --port=3000"

• --shm-size=1g：避免浏览器因共享内存不足崩溃
• 版本号需与Spring Boot中Playwright Java客户端版本严格一致

2. Spring Boot中连接Server #

添加Playwright Java依赖后，通过指定Endpoint连接远程Server：

// 初始化Playwright客户端连接远程Server
Playwright playwright = Playwright.create(new Playwright.CreateOptions()
    .setEndpoint("http://<playwright-server-ip>:3000"));

// 后续操作与本地调用完全一致
Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions()
    .setHeadless(true));
Page page = browser.newPage();
page.navigate("https://target-website.com");
// 抓取数据逻辑...

方案二：封装Playwright为独立微服务 #

如果需要更灵活的业务逻辑封装，可以将Playwright打包成独立的微服务，Spring Boot主应用通过HTTP接口调用：

1. 构建Playwright微服务镜像 #

编写Dockerfile（以Java为例），确保正确配置JAVA环境：

FROM openjdk:17-jdk-slim
WORKDIR /app

# 安装Playwright依赖的系统库
RUN apt-get update && apt-get install -y --no-install-recommends \
    libnss3 libatk-bridge2.0-0 libdrm-dev libxkbcommon-dev libgbm-dev libasound-dev libatspi2.0-0 libxshmfence-dev

# 复制微服务Jar包
COPY target/playwright-service.jar .

# 明确设置JAVA_HOME（解决你遇到的环境变量错误）
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# 启动服务
CMD ["java", "-jar", "playwright-service.jar"]

2. 微服务暴露抓取接口 #

在Playwright微服务中编写REST接口，接收抓取请求并返回数据，Spring Boot主应用通过HTTP调用该接口即可。

解决你遇到的JAVA_HOME错误 #

你克隆仓库运行容器时的错误，是因为镜像未正确配置Java环境：

• 若使用自定义镜像，必须在Dockerfile中明确设置JAVA_HOME（如上述方案二的Dockerfile）
• 若使用官方Java镜像，需确认镜像本身包含JAVA_HOME环境变量（如openjdk:17-jdk-slim默认已配置）

关键注意事项 #

• Playwright客户端与Server/微服务的版本必须完全匹配，否则会出现兼容性问题
• 运行Playwright容器时，建议添加--shm-size=1g参数，避免浏览器崩溃
• 若需要可视化调试，可在启动浏览器时关闭无头模式，并映射VNC端口（需额外安装VNC服务）

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