Docker部署Airflow对接GCP时Google凭证文件挂载失败求助

问题重现 #

执行以下命令启动Airflow时触发报错：

docker compose build
docker compose up

错误信息：

Error response from daemon: Mounts denied:
The path /.google/credentials/google_credentials.json is not shared from the host and is not known to Docker.
You can configure shared paths from Docker -> Preferences... -> Resources -> File Sharing.

配置问题分析 #

查看你的Docker Compose和环境配置，核心问题有两个：

1. 卷挂载路径错误：
   • scheduler服务中，你把主机目录~/.google/credentials/挂载成了容器内的文件/.google/credentials.json，属于语法错误（目录不能直接挂载为文件）
   • webserver服务中，主机路径写为/.google/credentials/google_credentials.json，但你的凭证实际存储在用户目录~/.google/下，路径不匹配
2. Docker未共享凭证所在目录：Docker默认不会共享用户目录下的隐藏子目录，需要手动添加到文件共享列表

修复步骤 #

1. 修正Docker Compose的卷挂载配置 #

修改scheduler和webserver服务的volumes字段，确保主机路径和容器路径正确对应：

services:
  scheduler:
    # ... 其他配置保留不变
    volumes:
      # ... 其他卷挂载保留不变
      - ~/.google/credentials/google_credentials.json:/.google/credentials/google_credentials.json:ro

  webserver:
    # ... 其他配置保留不变
    volumes:
      # ... 其他卷挂载保留不变
      - ~/.google/credentials/google_credentials.json:/.google/credentials/google_credentials.json:ro

说明：:ro表示只读挂载，符合凭证文件的安全要求；容器内路径必须和.env文件中GOOGLE_APPLICATION_CREDENTIALS的值完全一致

2. 配置Docker文件共享权限 #

• 打开Docker Desktop，进入Preferences（偏好设置）> Resources（资源）> File Sharing（文件共享）
• 点击+按钮，添加凭证所在目录：
  • Mac/Linux：/Users/<你的用户名>/.google（替换<你的用户名>为实际用户名）
  • Windows：C:\Users\<你的用户名>\.google
• 点击Apply & Restart，重启Docker使配置生效

3. 验证环境变量配置 #

保持.env文件中的配置不变即可，无需修改为相对路径：

GOOGLE_APPLICATION_CREDENTIALS=/.google/credentials/google_credentials.json
AIRFLOW_CONN_GOOGLE_CLOUD_DEFAULT=google-cloud-platform://?extra__google_cloud_platform__key_path=/.google/credentials/google_credentials.json

注意：终端执行export GOOGLE_APPLICATION_CREDENTIALS不会影响docker-compose的配置，因为docker-compose会直接读取.env文件

验证修复 #

重新执行以下命令：

docker compose down -v  # 清理旧容器和卷
docker compose build
docker compose up

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