如何在部署NextJS应用到Google Cloud Run时通过Build Arg传递PUBLIC_API_URL

1. 明确构建时与运行时环境变量的区别 #

• 如果你在Dockerfile里用ARG定义PUBLIC_API_URL，这是构建时变量，仅在镜像构建阶段有效；Cloud Run配置的是运行时环境变量，两者完全独立。如果应用代码是读取运行时变量，构建时传入的ARG不会被应用识别。
• 解决思路：让应用直接读取运行时环境变量（比如Node.js用process.env.PUBLIC_API_URL，Python用os.getenv("PUBLIC_API_URL")），而非依赖构建时注入的值。

2. 针对前端应用的特殊处理 #

如果是Vue、React这类前端框架，注意：构建时会把PUBLIC_前缀的环境变量打包进静态文件，运行时无法直接覆盖。这时候需要换一种方式传递变量：

• 用后端服务托管静态文件，在启动时读取运行时环境变量，再注入到前端页面。示例（Node.js）：

  // server.js
  const express = require('express');
  const app = express();
  const apiUrl = process.env.PUBLIC_API_URL || 'https://default-api.example.com';
  
  app.get('/', (req, res) => {
    res.send(`
      <!DOCTYPE html>
      <html>
        <head>
          <script>window.PUBLIC_API_URL = "${apiUrl}";</script>
        </head>
        <body>
          <div id="app"></div>
          <script src="/static/js/main.js"></script>
        </body>
      </html>
    `);
  });
  
  app.use(express.static('build'));
  app.listen(process.env.PORT || 8080);
  

• Dockerfile里设置启动命令为CMD ["node", "server.js"]，这样Cloud Run配置的PUBLIC_API_URL会被后端脚本读取，再传递给前端。

3. 验证Cloud Run环境变量配置 #

• 登录Google Cloud控制台，进入目标Cloud Run服务，查看「环境变量」面板，确认PUBLIC_API_URL的键值对正确无误。
• 或者用gcloud命令校验：

  gcloud run services describe YOUR_SERVICE_NAME --region YOUR_REGION
  

  查看输出中的envVars字段，确认变量存在且值正确。

4. 检查应用代码的变量读取逻辑 #

• 后端应用：在代码中添加日志输出，比如console.log('API地址:', process.env.PUBLIC_API_URL)，然后查看Cloud Run日志，确认是否能读取到变量。
• 前端应用：确保代码中是从window.PUBLIC_API_URL这类运行时注入的变量获取地址，而非依赖构建时打包的静态值。

5. 重新部署更新后的镜像 #

如果修改了Dockerfile或应用代码，需要重新构建镜像并推送到Google Container Registry，再重新部署Cloud Run服务，确保新配置生效。

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