Reactive-Resume项目Docker部署中PDF导出问题的分析与解决

问题背景

在使用Reactive-Resume项目进行简历制作时，用户通过Docker环境部署后发现PDF导出功能无法正常工作。当点击"导出PDF"按钮时，浏览器会打开一个空白页，URL显示为"about:blank"，同时Docker容器日志中出现了SSL协议错误的相关提示。

错误现象分析

从日志信息中可以清晰地看到，系统在尝试生成PDF时遇到了SSL协议错误。具体表现为Puppeteer（用于PDF生成的工具）无法通过HTTPS协议访问应用内部的预览页面，错误代码为"ERR_SSL_PROTOCOL_ERROR"。

根本原因

经过深入分析，发现问题的根源在于Docker环境配置不当，特别是以下几个方面：

1. 内部服务通信配置错误：容器间通信使用了错误的URL配置，导致内部服务无法正确建立HTTPS连接
2. SSL证书缺失：内部服务间通信尝试使用HTTPS但缺乏有效的SSL证书
3. 环境变量设置不当：特别是与浏览器服务和存储服务相关的配置存在问题

解决方案

要解决这个问题，需要进行以下配置调整：

1. 正确配置服务端点：

   • 确保内部服务通信使用正确的协议（HTTP而非HTTPS）
   • 使用容器名称而非localhost作为服务地址

2. 调整环境变量：

   • 修改PUBLIC_URL为正确的内部访问地址
   • 确保STORAGE_URL指向正确的Minio服务端点
   • 配置CHROME_URL指向浏览器服务

3. 添加必要的标签：

   • 为各个服务容器添加适当的网络标签
   • 确保反向代理配置正确

配置示例

以下是经过验证的有效配置示例（关键部分）：

services:
  app:
    environment:
      PUBLIC_URL: http://app:3000
      STORAGE_URL: http://rs-minio:9000/default
      CHROME_URL: ws://rs-chrome:3000
      STORAGE_ENDPOINT: rs-minio
      STORAGE_USE_SSL: false

实施建议

对于使用反向代理（如Traefik或Nginx Proxy Manager）的用户，建议：

1. 确保外部访问通过反向代理处理SSL终止
2. 内部服务间通信保持使用HTTP协议
3. 为每个服务容器配置正确的网络标签
4. 使用容器名称而非IP地址进行服务发现

总结

通过正确配置Docker环境中的服务通信参数，特别是内部服务间的URL设置，可以有效解决Reactive-Resume项目中的PDF导出问题。关键在于理解容器化环境中服务发现和通信的特殊性，避免在内部通信中不必要地使用HTTPS协议。对于生产环境部署，建议仔细规划网络架构和安全策略，确保既能满足功能需求，又能保障系统安全。