Flask与Gunicorn环境下正确配置Google凭据的方法

我之前也碰到过一模一样的坑——命令行跑YouTube API调用完全正常，一用Gunicorn搭Flask服务就弹出ApplicationDefaultCredentialsError，折腾了好一阵才搞明白问题出在哪，给你几个亲测有效的解决办法：

核心原因 #

Gunicorn启动时默认不会加载用户的.bashrc环境变量（因为它不是在交互式Shell环境下运行的），所以你在.bashrc里配置的GOOGLE_APPLICATION_CREDENTIALS根本没被Gunicorn进程读到。

解决方案1：启动Gunicorn时直接传递环境变量 #

最简单的办法就是在启动命令里直接指定环境变量，把路径硬写到启动参数里：

GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json gunicorn app:app --workers 16

这样环境变量会直接注入Gunicorn进程，肯定能被读取到。

解决方案2：在Flask代码里显式设置环境变量 #

如果不想每次启动都敲一大串命令，可以在应用代码里提前设置环境变量，注意一定要在导入oauth2client之前设置：

# 在app.py或者youtube_module.py的最顶部添加
import os
os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = '/path/to/credentials.json'

# 然后再导入凭据相关模块
from oauth2client.client import GoogleCredentials
CREDENTIALS = GoogleCredentials.get_application_default()

这样代码启动时会主动设置环境变量，不管用什么方式部署都能生效。

解决方案3：通过Gunicorn配置文件注入环境变量 #

如果你的项目用了Gunicorn配置文件（比如gunicorn.conf.py），可以在配置文件里添加一行：

raw_env = ['GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json']

然后用配置文件启动Gunicorn：

gunicorn -c gunicorn.conf.py app:app --workers 16

这种方式适合需要批量配置多个环境变量的场景，管理起来更整洁。

额外排查点：检查凭据文件的权限 #

有时候不是路径的问题，是Gunicorn运行的用户（比如服务器上的www-data）没有读取credentials.json的权限。可以用下面的命令调整权限：

chmod 644 /path/to/credentials.json

确保运行Gunicorn的用户能访问到这个文件。

内容的提问来源于stack exchange，提问作者8-Bit Borges