Docker+Nginx部署Django项目时无法访问redoc页面的配置问题求助

以下是配置中存在的可直接导致redoc页面无法访问的错误，以及对应修复方式：

1. docker-compose.yaml 卷挂载配置错误 #

当前nginx服务的卷挂载源路径写法错误，默认会指向系统隐藏目录，几乎所有项目的static、templates都为非隐藏目录，属于手误导致的路径不匹配：

# 错误配置
- .static/redoc.yaml:/var/html/redoc/redoc.yaml
- .templates/redoc.html:/var/html/redoc/redoc.html

修正为指向当前目录下的真实资源目录：

# 修正后配置
- ./static/redoc.yaml:/var/html/redoc/redoc.yaml
- ./templates/redoc.html:/var/html/redoc/redoc.html

额外注意：直接挂载单个文件到新目录时，docker会自动将目标路径的最后一级识别为文件而非目录，导致挂载失效，可补充一行匿名卷挂载确保父目录存在：

- /var/html/redoc/

2. Nginx 路径匹配逻辑错误 #

当前/redoc/的location规则存在两个问题：

• 访问/redoc（不带末尾斜杠）时无法匹配该规则，会被直接转发到Django服务返回404
• try_files的路径拼接逻辑错误，会多嵌套一层redoc目录，导致找不到静态文件
  修正后的Nginx配置：

# 重定向无斜杠的请求到带斜杠路径
location = /redoc {
    return 301 /redoc/;
}

location /redoc/ {
    root /var/html;
    index redoc.html;
    try_files $uri $uri/ /redoc/redoc.html =404;
}

3. 辅助排查项 #

如果修复上述问题后依然无法访问，可依次检查：

• 你贴出的docker-compose配置中web服务的image字段为空，实际部署时请补全你的Django镜像地址
• 打开redoc.html检查内部引用redoc.yaml的路径是否为绝对路径/redoc/redoc.yaml，避免相对路径导致资源加载失败
• 确认nginx容器对/var/html/redoc/目录下的文件有读权限，可临时在nginx服务配置中加user: root测试，验证后再调整为最小权限配置

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