Docker容器内FastAPI无法找到已确认正确的相对路径问题排查

我在Docker容器中运行FastAPI应用，需要访问app/secrets/LOCAL_DEV目录下的密钥（仅本地开发使用），但程序报错提示该目录不存在。

容器内工作目录的文件结构如下：

project/
├── app/
│   └── secrets/
│       └── LOCAL_DEV/
├── environments/
│   └── LOCAL_DEV/
└── main.py

已将容器工作目录设置为project，添加调试语句：

BASE_DIR = Path(__file__).resolve().parent
logger.debug(f"Current base directory: {BASE_DIR}")

确认输出的BASE_DIR为/project，但尝试app/secrets/LOCAL_DEV和project/app/secrets/LOCAL_DEV路径均无法解决问题，在容器外运行一切正常。

可能的原因及解决方法 #

1. Docker镜像构建时未复制secrets目录 #

Docker镜像不会自动打包本地所有文件，检查你的Dockerfile，确认是否包含复制app/secrets目录的指令：

# 复制本地app目录到容器工作目录的app文件夹
COPY ./app /project/app
# 或直接复制整个项目目录（适合需要完整文件结构的场景）
COPY . /project

如果Dockerfile仅复制了main.py和部分app子目录，漏掉app/secrets，容器内就不会存在该目录。

2. .dockerignore排除了secrets目录 #

检查项目根目录的.dockerignore文件，若存在app/secrets或secrets规则，会导致构建镜像时跳过该目录，需删除或注释相关规则：

# 注释或删除这行规则
# app/secrets/

3. 路径拼接方式存在歧义 #

虽然BASE_DIR为/project，但相对路径可能受上下文影响，建议用BASE_DIR拼接绝对路径，避免歧义：

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent
# 基于BASE_DIR生成绝对路径
SECRETS_DIR = BASE_DIR / "app" / "secrets" / "LOCAL_DEV"
logger.debug(f"Secrets directory path: {SECRETS_DIR}")

这种方式能确保路径基于已知的基准目录生成，不受工作目录潜在问题影响。

4. 容器卷挂载覆盖了目录 #

如果启动容器时用-v参数挂载本地目录到容器/project/app，可能覆盖容器内原本的app/secrets目录。检查启动命令，例如：

docker run -v $(pwd)/app:/project/app your-image

若本地app目录没有secrets子目录，容器内的对应目录会消失。可以修改挂载规则，仅挂载需要的子目录，或确保本地app/secrets目录存在且内容完整。

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