FastAPI部署于Google App Engine时Cloud Tasks重复触发是什么原因？

核心疑问解答 #

1. app.yaml中的GUNICORN_ARGS和Dockerfile启动参数的优先级 #

如果你使用GAE柔性环境的官方Python运行时（无自定义Dockerfile），GUNICORN_ARGS环境变量会覆盖gunicorn默认启动参数，优先级高于官方运行时内置Dockerfile中的默认启动命令。
但你当前项目已自定义了Dockerfile，GAE柔性环境会直接执行Dockerfile中定义的启动命令，app.yaml中配置的GUNICORN_ARGS不会被自动注入到启动流程中，此时Dockerfile的启动参数优先级更高。
额外需要注意：gunicorn自身的参数优先级为「命令行参数 > 配置文件参数 > 默认值」，你当前GUNICORN_ARGS中指定的-k gevent和配置文件中的worker_class = "uvicorn.workers.UvicornWorker"存在冲突，如果走官方运行时的启动逻辑，gevent这个WSGI worker会覆盖配置文件的ASGI worker，直接导致FastAPI请求处理异常。

2. 多worker是否是任务多次执行的直接原因 #

不是。gunicorn的多worker是进程级别的请求分发机制，同一个请求只会被分配给单个worker处理，不会出现多worker同时处理同一个请求的情况。
你遇到的4次调用，基本可以确定是Cloud Tasks的默认重试机制触发导致：Cloud Tasks要求任务处理方在指定时间内返回2xx状态码，若出现请求超时、返回5xx错误、连接断开等情况，就会自动重试，默认重试次数刚好为4次左右，和你遇到的现象完全吻合。

问题根因与修复方案 #

你当前配置的核心错误是GUNICORN_ARGS中指定了-k gevent参数：FastAPI是ASGI框架，必须使用uvicorn.workers.UvicornWorker这类ASGI worker才能正常运行，gevent是WSGI worker，无法兼容ASGI应用，会导致请求处理卡住、超时、返回5xx错误，触发Cloud Tasks重试，最终出现同一个任务被多次调用的问题。
修复步骤如下：

• 删掉GUNICORN_ARGS中的-k gevent参数，避免worker类型冲突
• 统一三处超时配置：保证「Cloud Tasks队列超时时间 > gunicorn的timeout参数 > 单任务实际最长处理时间」，避免因提前断开连接触发重试
• 给任务处理逻辑添加幂等性校验：比如每个任务携带唯一标识，处理前先校验是否已经处理过，即使出现重试也不会产生异常结果
• 若没有特殊自定义需求，可以删掉项目中的自定义Dockerfile，直接使用GAE官方Python运行时，减少配置冲突的可能

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