docker-compose下nginx无法加载CSS/JS等非PHP静态资源 返回404的配置排查
静态资源404问题根因定位
这个问题的核心触发原因是web(nginx)容器与app(php-fpm)容器的文件系统挂载未对齐,和你当前贴出的nginx配置逻辑本身没有冲突。
结合你的部署场景拆解下异常的产生逻辑:
- PHP页面可正常加载的原因:所有匹配
\.php$的请求,nginx不会在本地查找文件,而是通过FastCGI把脚本路径($document_root$fastcgi_script_name,即/var/www/public/xxx.php)传递给app容器的PHP-FPM服务。只要app容器的对应路径下存在该PHP文件,解析流程就能正常完成,输出正常的页面内容。 - 静态资源全部404的原因:CSS、JS等非PHP后缀的请求会命中
location /块的try_files规则,nginx必须在自身容器的本地文件系统、root指令指定的/var/www/public路径下找到匹配的静态文件,才能直接返回内容。如果web容器的这个路径下没有挂载项目源码,try_files自然无法定位到对应静态资源,就会走兜底逻辑把请求重写到/index.php?$args,最终由PHP框架返回“路由不存在”的404状态——这和你描述的“PHP正常、所有非PHP资源404”的症状完全匹配。
排查&修复步骤
- 第一步:核查web容器内的文件挂载状态
执行命令确认nginx容器内对应目录的实际内容:docker exec <你的web容器名称/容器ID> ls -al /var/www/public
如果目录为空、看不到项目入口文件和CSS/JS等静态资源目录,就是挂载配置缺失导致的问题。
修复时必须保证两个容器的源码挂载路径完全和nginx配置的root路径对齐:web(nginx)和app(PHP-FPM)都要把本地项目源码目录映射到容器内的/var/www/public路径。
对齐后的挂载配置参考:# docker-compose.yml 中web服务的配置 web: volumes: - ./本地项目源码目录:/var/www/public - ./本地nginx配置文件:/etc/nginx/conf.d/default.conf # docker-compose.yml 中app服务的配置 app: volumes: - ./本地项目源码目录:/var/www/public - 第二步:确认文件权限
修复挂载后如果静态资源仍返回404,检查web容器内nginx进程(运行用户通常为nginx或www-data)对/var/www/public下的静态资源是否具备读取权限,避免因权限不足导致nginx无法读取文件、返回404/403状态。
配置可在原项目正常运行的原因
你复用的这套配置原本可正常加载资源,是因为原项目大概率是单容器一体化部署(Nginx和PHP-FPM运行在同一个容器内),不存在容器间的文件系统隔离,Nginx和PHP-FPM读取的是同一份本地文件,自然能正常定位静态资源。拆分为两个独立容器后,如果只给PHP-FPM容器挂载了源码、未给Nginx容器同步挂载对应路径的源码,就会触发当前的异常。
内容的提问来源于stack exchange,提问作者simonw16
相关产品推荐
相关产品推荐

