Laravel Docker Compose容器修改路由/视图需重启，清缓存无效求助

一、先清除所有Laravel相关缓存 #

你仅执行了cache:clear，但Laravel针对路由、视图、配置有独立的缓存机制，必须针对性清除：

在PHP容器内执行以下命令：

php artisan route:clear
php artisan view:clear
php artisan config:clear
php artisan optimize:clear

注意：即使APP_ENV设为local，若之前手动执行过route:cache或view:cache，缓存文件仍会残留，必须手动清除才会生效。

二、检查PHP OPcache配置 #

PHP的OPcache会缓存脚本文件，导致本地修改后容器内的PHP无法实时感知变化。需确保OPcache的自动刷新配置正确：

1. 在本地创建php.ini文件，添加以下配置：

opcache.enable = 1
opcache.enable_cli = 1
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2
opcache.max_accelerated_files = 10000

2. 在Docker Compose的api服务中添加挂载，将本地php.ini挂载到容器的PHP配置目录（路径根据你的镜像调整，例如/usr/local/etc/php/php.ini）：

services:
  api:
    # ... 其他原有配置
    volumes:
      - '/data/projects/backend:/app:delegated'
      - '/path/to/your/local/php.ini:/usr/local/etc/php/php.ini'

三、调整Docker挂载与镜像配置 #

1. 移除重复的storage挂载：你已挂载整个/app目录，无需单独挂载storage，重复挂载可能引发文件同步异常。修改api服务的volumes配置：

volumes:
  - '/data/projects/backend:/app:delegated'

2. 检查镜像启动逻辑：确认public-backend:nightly镜像是否在启动时自动执行了缓存命令（如php artisan optimize）。若是，需修改镜像的启动脚本，在local环境下跳过缓存生成步骤。

四、验证文件同步有效性 #

进入PHP容器，查看修改后的文件内容是否与本地一致：

docker compose exec api cat /app/routes/web.php
# 或查看视图文件
docker compose exec api cat /app/resources/views/your-target-view.blade.php

若内容不一致，说明挂载同步存在问题：可尝试将挂载模式改为cached（适用于macOS/Windows环境），或检查本地目录权限是否与容器的PUID/PGID匹配。

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