Nginx 应避免直接 root 到 public 目录，推荐用 alias 指向 public 或 root 指向项目根并配合 SCRIPT_FILENAME 修正；.env 不应 COPY 进镜像，需运行时注入环境变量；php-fpm 容器须挂载 storage 和 bootstrap/cache 并确保 www-data 权限；artisan 命令必须在 php-fpm 容器中执行。
nginx 配置里别直接 root 到 public 目录
很多人一上来就把 nginx 的 root 指向 Laravel 项目的 public 目录，看似省事，实际埋雷。Docker 容器里路径映射稍有偏差、或用的是多阶段构建，root 路径很容易指向空目录或旧版本代码。
更稳的做法是显式指定 index 和 try_files，并用 alias 或固定 root 到项目根目录，再在 location 里拼出 public 路径：
location / {
alias /var/www/html/public/;
try_files $uri $uri/ /index.php?$query_string;
}
注意：alias 末尾必须带斜杠，且不拼接 location 路径；用 root 则写成 root /var/www/html; index public/index.php;，但得额外配 fastcgi_param SCRIPT_FILENAME $document_root/public/index.php; —— 否则 php-fpm 找不到入口文件。
APP_URL 和 DB_HOST 别写死在 .env
Docker 环境下，.env 文件一旦打进镜像就固化了，换环境就得重打镜像。Laravel 启动时读取的环境变量，应该由容器运行时注入，而不是靠 COPY 进去的静态文件。
实操建议：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 把
.env从Dockerfile的COPY列表里删掉 - 在
docker-compose.yml的environment或env_file中传入变量，例如：APP_URL=http://localhost:8000、DB_HOST=database -
DB_HOST必须填容器名（如database），不是localhost—— 容器内localhost指自己，不是宿主机也不是其他服务 - Laravel 9+ 默认用
$_ENV，确保php.ini开了variables_order = "EGPCS"（Docker 官方 PHP 镜像默认已开）
php-fpm 容器里要挂载 storage 和 bootstrap/cache
开发时本地权限没问题，一进 Docker 就报 Permission denied 写日志、缓存配置、生成路由缓存 —— 根源是 php-fpm 工作进程用户（通常是 www-data）没权限写容器内的 storage 和 bootstrap/cache 目录。
解决方式不是简单 chmod -R 777（不安全且重启容器即失效），而是：
- 在
docker-compose.yml中用volumes显式挂载这两个目录到宿主机（或命名卷） - 确保挂载后目录属主是
www-data：可在php-fpm容器启动命令里加chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache - 如果用 Alpine 镜像，注意
www-data用户可能不存在，需先addgroup -g 82 -r www && adduser -S -u 82 www
artisan 命令要在 php-fpm 容器里执行，不是 nginx 容器
新手常误以为在 nginx 容器里跑 php artisan migrate 或 php artisan storage:link 就行 —— 但 nginx 镜像通常不含 php-cli，就算有，也没装 Laravel 依赖、没加载 .env、没配好 autoload。
正确姿势：
- 所有
artisan操作都进php-fpm容器执行：docker-compose exec php-fpm php artisan migrate - 首次部署务必跑一遍：
php artisan config:clear && php artisan cache:clear && php artisan config:cache—— 否则容器里读的还是旧缓存 -
php artisan storage:link生成的是相对路径软链，挂载storage卷后，链接目标必须在卷内有效；若链接指向../storage/app/public，而storage是单独挂载的卷，则需确保该路径在卷内真实存在
最麻烦的其实是权限和路径错位，不是命令本身。跑不通时先 ls -l storage 和 id 看属主和路径是否对得上，比瞎试参数快得多。
