在Google Cloud Run运行Hello World Python脚本遇端口错误求助

核心原因解析 #

Cloud Run本质是托管的HTTP服务，它要求容器必须监听PORT环境变量指定的端口（默认8080），原因有两点：

1. 健康检查机制：Cloud Run会定期向该端口发送请求，只有能正常响应的容器才会被标记为可用，否则会判定启动失败。
2. 任务触发逻辑：Cloud Scheduler是通过向Cloud Run服务发送HTTP请求来触发脚本执行的，你的脚本需要在接收到请求时运行，而非启动就直接执行后退出。

不管是否使用Flask，只要部署到Cloud Run，都必须满足这个端口监听要求，这是平台的强制规则。

解决方案（无需Flask） #

方案1：用Python内置HTTP服务器实现 #

利用Python标准库的http.server，搭建极简HTTP服务，在收到请求时执行你的脚本逻辑：

import os
from http.server import BaseHTTPRequestHandler, HTTPServer

class TaskHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        # 替换成你的Hello World或业务脚本逻辑
        print("Hello World!")
        
        # 返回响应，满足Cloud Run健康检查和调度要求
        self.send_response(200)
        self.send_header('Content-type', 'text/plain')
        self.end_headers()
        self.wfile.write(b"Task completed")

if __name__ == "__main__":
    # 读取PORT环境变量，默认8080
    port = int(os.getenv('PORT', 8080))
    server = HTTPServer(('', port), TaskHandler)
    print(f"Listening on port {port}")
    server.serve_forever()

对应的Dockerfile：

FROM python:3.11-slim

WORKDIR /app
COPY your_script.py .

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

方案2：用轻量Web框架FastAPI（推荐） #

如果需要更灵活的请求处理（比如POST请求、参数传递），FastAPI比Flask更轻量且性能更好：

import os
from fastapi import FastAPI
import uvicorn

app = FastAPI()

@app.get("/run-task")
def run_task():
    # 你的脚本逻辑
    print("Hello World!")
    return {"status": "success", "message": "Task executed"}

if __name__ == "__main__":
    port = int(os.getenv('PORT', 8080))
    uvicorn.run(app, host="0.0.0.0", port=port)

对应的Dockerfile：

FROM python:3.11-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY your_script.py .

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

requirements.txt内容：

fastapi
uvicorn

关键注意事项 #

• 不要让脚本启动后直接执行逻辑然后退出，必须保持HTTP服务持续运行监听端口
• Cloud Scheduler配置时，要将请求地址指向Cloud Run服务的URL（比如https://your-service-url.run.app/run-task），请求方法设为GET或POST，匹配你的服务处理逻辑

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