Cloud Run Jobs部署Flask应用报错：''不是有效端口号

问题情况 #

基于Python Flask构建的应用，部署为Cloud Run服务时通过本地curl可正常触发，但改用Cloud Run Jobs执行时失败，日志显示：

2022-12-23 01:54:05.403 JST
Error: '' is not a valid port number.
2022-12-23 01:54:05.437 JST
Container called exit(1).

应用的端口配置如下：
Dockerfile启动命令依赖$PORT环境变量：

CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 main:app

main.py中通过环境变量获取端口：

if __name__ == "__main__":
    app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))

尝试手动添加PORT环境变量时，系统提示该名称为保留变量，无法自定义设置。

解决方案 #

1. 修改Dockerfile，指定固定端口 #

Cloud Run Jobs是一次性执行任务，无需对外提供服务监听端口，因此可以直接将启动命令中的$PORT替换为固定端口（如8080）：

CMD exec gunicorn --bind :8080 --workers 1 --threads 8 --timeout 0 main:app

如果不需要gunicorn，也可以直接运行main.py（适合轻量任务）：

CMD ["python", "main.py"]

2. 调整任务执行逻辑（可选优化） #

如果你的需求是执行一次性任务而非运行长期服务，可以直接在main.py中调用任务函数，避免启动Flask服务：

from flask import Flask
import os

app = Flask(__name__)

def execute_task():
    # 这里编写你的任务逻辑
    print("任务执行完成")

if __name__ == "__main__":
    # 作为Job运行时直接执行任务
    execute_task()
    # 保留服务模式（可选，用于测试或偶尔作为服务启动）
    # if os.environ.get("RUN_AS_SERVICE") == "true":
    #     app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))

原因说明 #

Cloud Run服务会自动注入PORT环境变量，用于指定服务监听的端口；但Cloud Run Jobs作为一次性任务，不需要对外提供服务，因此系统不会自动设置PORT变量，且该变量属于系统保留名称，用户无法手动添加，导致启动命令中$PORT为空字符串，触发端口无效错误。

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