You need to enable JavaScript to run this app. Docker环境下Laravel7应用访问storage目录文件报404问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Docker环境下Laravel7应用访问storage目录文件报404问题求助

问题核心根因

这个场景下storage路径404的本质是运行Nginx的web容器未与app容器共享完整的项目工作目录,逻辑链非常清晰:

  • Laravel执行storage:link的本质,是在项目public目录下生成一个指向storage/app/public的符号链接,Web服务器进程需要顺着这个链接读取真实的上传文件。
  • 当前docker-compose配置里,只有app容器把本地项目全量挂载到了/var/www路径,web容器只单独挂载了日志目录,既没有完整的项目目录访问权限,也读不到动态生成的符号链接、用户上传的文件。
  • 静态资源能正常访问,是因为web容器构建阶段已经把固化在镜像里的CSS、JS等静态文件做了COPY;但运行时新增的上传文件、新建的软链因为没有共享卷,根本不在web容器的文件系统里,自然会返回404。
修复操作步骤
  • 修正web服务的卷挂载配置,保证web和app容器的项目挂载路径100%一致,修改后的docker-compose.yml中web段参考配置:
web:
  container_name: web
  build:
    context: ./
    dockerfile: development/web.dockerfile
  volumes:
    # 与app容器保持完全相同的项目挂载路径,避免软链路径识别失败
    - ./:/var/www
    - ./storage/logs/:/var/log/nginx
  ports:
    - 8990:80
  • 校验Nginx站点配置,确保站点根目录指向web容器内的/var/www/public,不要错误指向项目根目录,避免触发路由404。
  • 重建符号链接:进入app容器执行php artisan storage:link --force,强制重新生成软链,保证软链的绝对路径和web容器内的项目路径完全匹配。
  • 有效性验证:进入web容器执行ls -l /var/www/public/storage,如果能看到软链正常指向/var/www/storage/app/public,且目标路径下的上传文件可被读取,即可正常访问storage路径下的资源。
常见踩坑提示
  • 不要单独拆分挂载public或storage目录,很容易出现软链指向的上游路径在web容器内不存在的问题,开发环境下全量挂载项目目录是最稳妥的方案。
  • 如果修改挂载后仍然404,检查Nginx配置是否开启了disable_symlinks选项,开启状态下Nginx会直接拒绝访问带软链的路径,需要将该配置值设为off。

内容的提问来源于stack exchange,提问作者Yassine Nat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 22:36:04