Docker中运行的Next.js经Apache2反向代理出现502错误求助

排查步骤及修复方法 #

1. 验证后端服务可达性 #

直接在服务器上执行命令测试能否访问Next.js的静态资源：

curl http://127.0.0.1:3000/_next/static/css/175964cd052c7c3f.css

• 如果返回资源内容，说明后端服务正常，问题出在Apache配置或模块；
• 如果返回连接失败/超时，说明Docker容器的端口映射有问题：
  • 检查容器启动命令的端口映射参数，确保是-p 3000:3000（监听服务器所有IP）或-p 127.0.0.1:3000:3000（仅本地）；
  • 若使用自定义Docker网络，需用容器IP或容器名替代127.0.0.1，先通过docker inspect <容器ID> | grep IPAddress获取容器IP，再修改Apache的ProxyPass目标为该IP。

2. 确保Apache代理模块已启用 #

执行以下命令启用必要模块并重启Apache：

a2enmod proxy proxy_http
systemctl restart apache2

3. 调整Apache代理配置细节 #

修改VirtualHost配置，补充代理请求头并优化超时设置，同时确保ProxyPass规则顺序正确：

<VirtualHost *:80>
        ServerName example.com
        ServerAlias example.com

        ProxyPreserveHost On
        ProxyRequests Off
        ProxyVia On
        
        # 排除路径需放在ProxyPass /之前
        ProxyPass /excluded !
        # 添加ProxyTimeout与后端超时匹配
        ProxyTimeout 6000
        ProxyPass / http://127.0.0.1:3000/ connectiontimeout=6000 timeout=6000
        ProxyPassReverse / http://127.0.0.1:3000/
        
        # 传递必要的请求头给Next.js
        RequestHeader set X-Forwarded-Proto "http"
        RequestHeader set X-Forwarded-Host "example.com"

        CustomLog /var/log/apache2/mydomain.access.log combined
        ErrorLog /var/log/apache2/mydomain.error.log
</VirtualHost>

修改后重启Apache：

systemctl reload apache2

4. 检查Next.js静态资源配置 #

如果上述步骤无效，检查next.config.js是否需要配置assetPrefix（仅当部署在子路径时需要，根路径部署可忽略）：

module.exports = {
  assetPrefix: process.env.NODE_ENV === 'production' ? 'http://example.com' : '',
}

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