Reactive-Resume项目PDF导出失败问题分析与解决方案

问题背景

在使用Reactive-Resume项目时，用户报告了一个常见问题：当尝试下载简历为PDF格式时，浏览器会打开一个空白页面(about:blank)，而不是预期的PDF文件。这个问题在Chrome和Firefox浏览器上都会出现，而JSON导出功能却能正常工作。

错误分析

从错误日志中可以观察到几个关键点：

1. 浏览器连接超时：日志显示"Websocket job has timedout"，表明浏览器连接在10秒后超时。

2. 协议错误：出现"Protocol error (Page.navigate): Target closed"错误，说明在尝试导航到PDF生成页面时，目标浏览器已经关闭。

3. 容器间通信问题：错误发生在Docker容器环境中，特别是当使用WSL 2运行Docker时。

根本原因

经过深入分析，这个问题主要由以下因素导致：

1. Docker容器网络配置不当：默认配置下，容器间的网络通信可能存在问题，特别是浏览器服务与应用服务之间的WebSocket连接。

2. 环境变量设置不正确：PUBLIC_URL和STORAGE_URL的配置可能指向了错误的地址。

3. 主机名解析问题：容器内部无法正确解析主机名，导致无法建立稳定的连接。

解决方案

1. 修改Docker Compose配置

在chrome服务下添加extra_hosts配置，解决主机名解析问题：

extra_hosts:
  - host.docker.internal:host-gateway

2. 调整环境变量设置

更新app服务中的环境变量：

PUBLIC_URL: http://localhost:3000/
STORAGE_URL: http://localhost:9000/default

3. 完整配置示例

以下是经过验证的有效配置示例：

version: "3.8"

services:
  postgres:
    image: postgres:15-alpine
    restart: unless-stopped
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres

  minio:
    image: minio/minio
    restart: unless-stopped
    command: server /data
    ports:
      - 9000:9000
    volumes:
      - minio_data:/data
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin

  chrome:
    image: ghcr.io/browserless/chromium:latest
    restart: unless-stopped
    extra_hosts:
      - host.docker.internal:host-gateway    
    environment:
      TIMEOUT: 10000
      CONCURRENT: 10
      TOKEN: chrome_token

  redis:
    image: redis:alpine
    restart: unless-stopped
    command: redis-server --requirepass password

  app:
    image: amruthpillai/reactive-resume:latest
    restart: unless-stopped
    ports:
      - 3000:3000
    depends_on:
      - postgres
      - minio
      - redis
      - chrome
    environment:
      PUBLIC_URL: http://localhost:3000
      STORAGE_URL: http://localhost:9000/default
      CHROME_TOKEN: chrome_token
      CHROME_URL: ws://chrome:3000
      DATABASE_URL: postgresql://postgres:postgres@postgres:5432/postgres

volumes:
  minio_data:
  postgres_data:

其他注意事项

1. 清除旧数据：在应用新配置前，建议清除旧的Docker卷，以避免缓存导致配置不生效。

2. 本地IP替代：在某些网络环境下，可能需要将localhost替换为本地服务器的实际IP地址。

3. 网络加速设置：如果使用了CDN等网络加速服务，可能需要暂时关闭加速功能以确保连接稳定。

4. 超时设置：可以根据实际网络情况适当调整TIMEOUT参数的值。

总结

通过正确配置Docker容器间的网络通信和环境变量，可以解决Reactive-Resume项目中PDF导出失败的问题。这个案例也提醒我们，在容器化部署时，需要特别注意服务间的网络连接和主机名解析问题。对于类似的多容器应用，合理的网络配置是确保各组件正常协作的关键。