Laravel子目录部署需确保Web服务器仅暴露public目录，并正确配置SCRIPT_NAME、RewriteBase或Nginx的alias与重写规则，否则静态资源404或路由失效。
Apache下public目录没放对位置，Laravel根本不会启动
很多人把整个Laravel项目直接扔进htdocs或/var/www/html，结果访问时看到的是满屏的文件列表，或者直接报NotFoundHttpException——其实Laravel压根没跑起来。核心问题在于：Web服务器必须只暴露public目录，其余文件（如app、config、vendor）绝不能被外部访问。
正确做法是把public目录内容（含index.php和.htaccess）作为Web根目录；如果只能把项目放在子目录（比如http://localhost/myapp/），那就得让index.php知道它不在根路径上：
- 打开
public/index.php，找到require __DIR__.'/../vendor/autoload.php';这一行，在它前面加：$_SERVER['SCRIPT_NAME'] = '/myapp/index.php';
- 确保
.htaccess在public目录里且已启用（AllowOverride All） - 不要手动改
APP_URL来“凑”子目录，那只会让生成URL出错，真正起作用的是SCRIPT_NAME和重写规则配合
Nginx子目录重写漏掉index.php，路由全404
Nginx不像Apache自动读.htaccess，所有重写逻辑必须显式写进server配置。常见错误是只写了根路径的try_files，一放到子目录（如/myapp/）就失效——因为location /匹配不到/myapp/xxx。
关键点在于用location ^~ /myapp/精确匹配子目录，并把URI重写干净：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 在server块里加：
location ^~ /myapp/ {<br> alias /path/to/your/project/public/;<br> try_files $uri $uri/ @laravel;<br>}<br><br>location @laravel {<br> rewrite ^/myapp/(.*)$ /myapp/index.php?/$1 last;<br>} -
alias末尾必须带/，否则文件路径拼接会错位 - 别用
root代替alias，否则/myapp/css/app.css会被映射成/path/.../public/myapp/css/app.css（多了一层myapp） - 重写后的
QUERY_STRING要保留?$1，不然Laravel的Request对象拿不到原始路径
Apache .htaccess里RewriteBase不填对，子目录下CSS/JS全404
即使Laravel路由能走通，静态资源（css/app.css、js/app.js）仍可能404——这是.htaccess里的RewriteBase没设准。它不是告诉Laravel项目在哪，而是告诉mod_rewrite：“所有重写规则的基准路径是这个”。
假设项目部署在http://example.com/myapp/，那么.htaccess必须明确声明：
- 在
public/.htaccess中，RewriteEngine On下面立刻加一行：RewriteBase /myapp/
- 注意结尾斜杠不能少，否则
/myapp/css/app.css会被错误重写为/myapp/css/app.css→/myapp/index.php/css/app.css - 如果用
php artisan serve本地调试，RewriteBase无效（它只对Apache生效），此时应检查APP_URL是否设为http://localhost:8000/myapp，否则asset()生成的链接还是错的
Laravel APP_URL和asset()函数在子目录下容易误配
APP_URL只影响邮件、通知、API返回的绝对URL生成，不影响路由匹配或重写。但很多人以为改了它就能解决子目录问题，结果反而让asset('css/app.css')输出http://localhost/myapp/css/app.css（正确），却因Web服务器没配好而404——这其实是环境配置和Web服务器配置没对齐。
- 开发时用
php artisan serve --host=localhost --port=8000，APP_URL设为http://localhost:8000即可，不用加子目录 - 生产环境部署到子目录，
APP_URL必须带子目录路径，例如https://example.com/myapp，否则邮件里的链接会指向根域名 -
asset()生成路径是否带子目录，取决于当前请求的base_path()和APP_URL共同作用，但最终能否加载成功，只取决于Web服务器能否把/myapp/css/app.css正确映射到public/css/app.css
子目录部署真正的难点从来不在Laravel代码里，而在Web服务器如何把“用户看到的URL路径”精准翻译成“磁盘上的文件路径”。哪怕index.php能执行，只要中间任何一层（RewriteBase、alias、SCRIPT_NAME）没对齐，就会出现部分请求通、部分404的诡异现象。
