Windows环境下Laravel Sail部署后API接口响应缓慢问题求助

核心原因（90%概率为Windows跨文件系统挂载性能问题） #

Windows环境下Docker Desktop访问Windows NTFS分区的挂载目录时，跨文件系统IO性能会大幅下降。Laravel运行时需要频繁读取vendor目录下的类文件、storage下的缓存/日志文件，直接绑定挂载Windows本地目录到容器内，会导致每次请求的IO耗时陡增，这是你本地直接运行接口耗时不到5秒，容器内却要30秒的最主要诱因。

优先级最高的修复方案 #

• 将整个项目代码迁移到WSL2的Linux文件系统内（例如路径/home/你的用户名/projects/下），在WSL2终端中执行Sail启动命令，此时文件读写均在Linux原生ext4文件系统内完成，性能可恢复到和本地直接运行接近的水平。
• 如果必须将代码存放在Windows NTFS分区，可修改docker-compose.yml优化挂载配置，避免读写频繁的目录走跨系统IO：
  找到laravel.test服务的volumes配置，新增两个匿名卷覆盖高频读写目录：

  volumes:
      - '.:/var/www/html'
      # 新增以下两行
      - 'sailvendor:/var/www/html/vendor'
      - 'sailstorage:/var/www/html/storage'
  

  再在配置最底部的volumes节点下新增两个卷声明：

  volumes:
      sailmysql:
          driver: local
      sailredis:
          driver: local
      sailmeilisearch:
          driver: local
      # 新增以下两行
      sailvendor:
          driver: local
      sailstorage:
          driver: local
  

  修改后重启Sail即可。

其他可排查优化点 #

• 确认Xdebug未意外启用：检查项目.env文件，确保存在配置SAIL_XDEBUG_MODE=off，Xdebug即使未启动调试也会带来显著的性能开销。
• 开启PHP OPcache：修改Sail对应PHP版本的Dockerfile，启用OPcache扩展并配置合理参数，可大幅降低PHP代码解析开销，示例配置：

  opcache.enable=1
  opcache.memory_consumption=256
  opcache.max_accelerated_files=100000
  opcache.validate_timestamps=1
  opcache.revalidate_freq=30
  

• 按需开启Laravel运行缓存：开发环境可执行sail artisan config:cache、sail artisan route:cache减少每次请求的配置、路由解析开销，修改配置或路由后需重新执行对应命令刷新缓存。
• 确认Docker Desktop已切换到WSL2后端，相比传统Hyper-V后端WSL2的IO和运行性能提升非常明显。

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