为什么Nginx配置的root与location指令未生效？

这套配置在Linux正常、Mac异常的核心原因集中在Nginx配置未生效，按概率从高到低排列如下：

1. 自定义配置挂载异常（最高概率） #

官方Nginx镜像默认加载/etc/nginx/conf.d/目录下所有.conf后缀的配置文件，Mac版Docker存在特殊的挂载逻辑：当你要挂载的本地文件不存在/路径写错时，Docker不会抛出启动错误，而是自动在容器对应路径创建目录，Nginx不会把目录识别为配置文件加载，因此你的自定义规则完全未生效，Nginx使用内置默认配置，root路径默认为/usr/share/nginx/html，刚好匹配你看到的错误日志。

Linux版Docker挂载不存在的本地文件会直接报错启动失败，不会出现配置静默不加载的情况，这也是你在Linux上运行正常的原因。

你可以执行以下命令验证该问题：

docker compose exec web ls -l /etc/nginx/conf.d/nginx.conf

如果输出结果开头为d，说明该路径是目录，确认是该问题。

2. 配置加载优先级冲突 #

如果验证后确认配置是正常文件，那就是默认配置冲突导致：
官方Nginx镜像自带/etc/nginx/conf.d/default.conf默认配置，里面的server块监听80端口，server_name为localhost，且优先级高于你没有配置server_name的自定义server块，请求localhost时会优先匹配默认配置，导致你写的root指令被忽略。

3. 路径大小写不匹配（Mac特有问题） #

Mac的文件系统默认大小写不敏感，Linux为大小写敏感，如果你的本地项目目录实际大小写和配置中写的不一致（比如本地是App目录，配置里写的是./app），在Linux上会直接挂载失败，在Mac上会被识别为合法路径，但可能导致容器内文件读取异常。

1. 先清理旧的错误容器与挂载：

docker compose down -v

2. 验证本地配置文件：确认./docker/nginx/nginx.conf真实存在，文件后缀为.conf（注意Mac默认隐藏文件后缀，避免实际是nginx.conf.txt的情况）
3. 调整挂载配置避免冲突，二选一即可：
   • 方案1：直接把自定义配置挂载为默认站点配置，覆盖默认的default.conf
     修改docker-compose.yml中web服务的volumes规则：

     volumes:
       - ./docker/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
       - ./app:/app
     

   • 方案2：启动时自动删除默认配置，在web服务中添加command指令：

     command: /bin/sh -c "rm -f /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'"
     

4. 启动后验证配置是否正常加载：

docker compose exec web nginx -T

确认输出的配置中包含你写的root /app/public规则即可。

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