本地Docker运行Airflow连接GCP报错：keyfile相关字段互斥问题求助

错误原因 #

你在配置Google Cloud连接时，同时填写了keyfile_dict、key_path、key_secret_name中的两个或全部三个字段，而Airflow要求这三个认证字段只能选其一，不能同时提供多个。

具体解决步骤 #

根据你的实际认证方式，选择以下一种配置方式，清空另外两个字段：

方式1：使用本地密钥文件路径（key_path） #

• 确保你的Google Cloud服务账号密钥文件（.json格式）已经挂载到Docker容器内的可访问路径（比如/opt/airflow/gcp-key.json）
• 在Airflow连接的Extra字段里，只保留key_path配置，示例：

  {"key_path": "/opt/airflow/gcp-key.json"}
  

• 清空keyfile_dict和key_secret_name相关的所有内容

方式2：使用密钥文件内容（keyfile_dict） #

• 打开你的Google Cloud服务账号密钥.json文件，复制全部内容
• 在Airflow连接的Extra字段里，将内容作为keyfile_dict的值，示例：

  {"keyfile_dict": {"type": "service_account", "project_id": "your-project-id", "private_key_id": "xxx", ...}}
  

• 清空key_path和key_secret_name相关的所有内容

方式3：使用Secret Manager中的密钥名称（key_secret_name） #

• 确保你的Airflow环境已经配置好访问Google Cloud Secret Manager的权限
• 在Airflow连接的Extra字段里，只保留key_secret_name配置，示例：

  {"key_secret_name": "projects/your-project-id/secrets/your-secret-name/versions/latest"}
  

• 清空keyfile_dict和key_path相关的所有内容

额外注意事项 #

• 配置完成后，点击Test Connection验证是否成功
• 如果是Docker运行的Airflow，使用key_path时要确认密钥文件的挂载路径在容器内是正确的，可通过docker exec -it <airflow-container-name> ls /opt/airflow检查路径是否存在

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