GCP Cloud Run Job无法接收调用参数问题排查

• 检查Dockerfile的命令定义形式
  Cloud Run Job的参数是传递给容器的入口命令的，若Dockerfile使用ENTRYPOINT和CMD的组合，需注意：

  • 必须使用exec形式的命令定义（比如ENTRYPOINT ["python", "main.py"]），传递的args才会追加到命令后；
  • 如果用shell形式（比如ENTRYPOINT python main.py或仅用CMD python main.py），容器会启动子shell，传递的参数会被直接忽略。
    示例正确Dockerfile：

  FROM python:3.11-slim
  WORKDIR /app
  COPY main.py .
  ENTRYPOINT ["python", "main.py"]
  

• 确认Job部署时的命令配置
  若部署Job时通过控制台或gcloud run jobs deploy指定了--command/--args，这些配置会覆盖Dockerfile内容。如果部署时设置的--command是shell类命令（比如bash），传递的参数无法转发到业务代码中，需确保部署命令指向你的应用执行文件的exec形式。

• 验证代码读取参数的逻辑
  不同语言读取命令行参数的方式不同，需确认代码未错误读取：

  • Python：用sys.argv[1:]（sys.argv[0]是脚本本身，后续才是传递的参数）
  • Java：用String[] args数组
  • Node.js：用process.argv.slice(2)
    示例Python读取代码：

  import sys
  if __name__ == "__main__":
      print(f"接收的参数: {sys.argv[1:]}")
  

• 检查ContainerOverrides的参数格式
  编程调用时，ContainerOverrides的args必须是字符串数组，不能将多个参数合并为单个字符串。示例Python客户端库的正确写法：

  from google.cloud import run_v2
  
  client = run_v2.JobsClient()
  request = run_v2.RunJobRequest(
      name="projects/[PROJECT_ID]/locations/[REGION]/jobs/[JOB_NAME]",
      overrides=run_v2.RunJobRequest.Overrides(
          container_overrides=[
              run_v2.RunJobRequest.Overrides.ContainerOverride(
                  args=["arg1的值", "arg2的值"]
              )
          ]
      )
  )
  response = client.run_job(request=request)
  

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