根本原因是PHP进程（如www用户）对storage/、bootstrap/cache/、public/uploads等目录无写权限，导致文件写入失败；需递归修改属主为web服务用户（如chown -R www:www）、设置合理目录权限（755或临时775），并确保APP_URL、Nginx root路径、PHP运行用户四者一致。
php artisan admin:install 报错 “Permission denied”
根本原因不是 Laravel 本身，而是 php artisan admin:install 在执行迁移和资源写入时，需要往 storage/、bootstrap/cache/ 和 public/uploads/ 这几个目录写文件。如果当前 PHP 进程（通常是 www 或 nginx 用户）没有这些目录的写权限，就会直接报错，比如：
file_put_contents(/path/to/storage/framework/cache/data/...): Failed to open stream: Permission denied
常见于 LNMP 环境（如 lnmp1.6）或手动部署时未调整用户组。
- 先确认 Web 服务运行用户：查
/usr/local/nginx/conf/nginx.conf中的user指令，或运行ps aux | grep nginx看 worker 进程所属用户（通常为www） - 递归修改项目目录归属：
chown -R www:www /path/to/your/laravel（注意不是只改public/） - 确保关键目录可写：
chmod -R 755 storage bootstrap/cache public/uploads；若仍不行，临时用775排查（上线前务必回调） - 避免在 root 用户下执行
php artisan命令——这会生成 root 所有、www 无法覆盖的缓存文件
public/uploads 目录上传失败或 403
laravel-admin 默认图片上传路径是 public/uploads，但 Nginx/Apache 默认禁止直接访问该目录下的脚本执行，同时可能因权限或配置缺失导致上传后无法显示。
- 检查目录是否存在且可写：
ls -ld public/uploads，应显示类似drwxr-xr-x 2 www www - Nginx 配置中需显式允许该目录访问（尤其当启用了
location ~ \.php$全局拦截时）：location ^~ /uploads/ { alias /path/to/public/uploads/; expires 1h; add_header Cache-Control "public, immutable"; } - 若用的是 lnmp1.6，默认不自动创建
public/uploads，需手动建目录并赋权：mkdir -p public/uploads && chown www:www public/uploads - 上传失败还可能是
upload_max_filesize或post_max_size过小，检查php.ini并重启 PHP-FPM
vendor:publish 后静态资源 404
执行 php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider" 后，资源（CSS/JS）仍 404，说明发布成功了，但 Web 服务器没把请求正确路由到 public/ 下的对应路径。
- 确认资源已发布到
public/vendor/laravel-admin（不是resources/views或vendor源码目录） - Nginx 配置中
root必须指向项目根目录下的public/，不是项目根目录本身；错误示例：root /var/www/myapp;→ 应为root /var/www/myapp/public; - LNMP 环境下，虚拟主机配置里必须包含
try_files $uri $uri/ /index.php?$query_string;，否则静态资源路径无法 fallback 到 Laravel 路由 - 清空浏览器缓存或用隐身窗口测试，避免 304 缓存干扰判断
APP_URL 和 asset() 生成链接错误
后台页面里 CSS/JS 的 URL 显示成 http://localhost:8000/vendor/... 或 http://127.0.0.1/admin/...，点开 404，本质是 asset() 辅助函数依赖 APP_URL 配置，而它被设错了。
- 检查
.env文件中的APP_URL是否为真实可访问域名，例如：APP_URL=https://admin.example.com（不能是http://localhost或留空） - 修改后必须运行
php artisan config:clear，否则缓存的配置不会更新 - 如果用子目录部署（如
https://example.com/backend/），仅改APP_URL不够，还需在config/admin.php中设置'route' => ['prefix' => 'backend']，并确保 Nginx 的location匹配该前缀 - 调试技巧：在 Blade 模板中临时加
{{ config('app.url') }}查看实际值
APP_URL、Nginx root 这四者之间有一处对不上——它们必须全部指向同一个“物理路径 + 访问协议 + 用户身份”。 
