需在.htaccess顶部添加rewriterule ^vendor(/|$) - [l]显式放行vendor路径，防止泛匹配规则劫持autoload.php请求；同时确认allowoverride all已启用，避免.htaccess被忽略。
Apache下vendor/autoload.php被404或403拦截怎么办
不是autoload.php写错了，是.htaccess重写规则把它拦在了PHP解析流程之外。典型现象是Class not found但vendor/autoload.php物理存在、可读——用curl -I /vendor/autoload.php返回404或403就坐实了这点。
根本原因是Apache先匹配.htaccess规则，再决定是否交给PHP处理。泛匹配如RewriteRule .* index.php [L]会把/vendor/autoload.php也重定向过去，导致PHP根本没机会执行它。
-
RewriteRule ^vendor(/|$) - [L]必须放在所有重写规则最顶部，[L]不能省，否则后续规则仍可能生效 -
^vendor(/|$)比^vendor/更安全，覆盖/vendor和/vendor/autoload.php两种路径 - 如果项目用了
composer.json或phpunit.xml等敏感配置文件，也建议加RewriteRule ^(composer\.(json|lock)|phpunit\.xml) - [L,R=404]防暴露 - 检查
AllowOverride是否为All——若httpd.conf里设了AllowOverride None，整个.htaccess直接失效
Nginx中index.php入口被重写后autoload失效的常见配置坑
Nginx不读.htaccess，但它的location块容易误伤vendor/路径。错误配置会让/vendor/autoload.php被当成静态资源返回源码，或触发404 Not Found。
关键不是“怎么写重写”，而是“怎么放行真实PHP文件”。Nginx默认不会自动识别vendor/该走PHP还是静态路径，必须显式声明。
- 在
location ~ \.php$块之前，加location ^~ /vendor/ { internal; }或location /vendor/ { deny all; }——前者禁止外部访问，后者彻底拒绝，避免源码泄露 - 确保
fastcgi_pass只作用于合法入口（如index.php），不要用location ~ \.php$全局匹配，否则/vendor/autoload.php会被当作普通PHP脚本执行，而它本身不含<?php标签，直接报错 - 如果用
try_files $uri $uri/ /index.php?$query_string;，要确认$uri没命中/vendor/autoload.php——它必须真实存在且可读，否则Nginx会fallback到/index.php，造成循环或空白页
为什么require 'vendor/autoload.php'在public/index.php里有时不生效
问题不在require语句本身，而在Web服务器根本没让index.php进入PHP执行阶段。常见于本地开发环境（XAMPP/MAMP）或Docker容器中。
先验证PHP是否真正启用：直接访问/index.php，输出phpinfo()；如果显示纯文本或下载，说明PHP处理器没挂载成功。
- 检查Apache的
AddHandler application/x-httpd-php .php是否生效，或Nginx的fastcgi_pass指向正确PHP-FPM socket/IP - 确认
index.php所在目录有AllowOverride All（Apache）或index index.php（Nginx）配置 - 如果用了
SetHandler application/x-httpd-php，留意是否被<filesmatch></filesmatch>之类块覆盖，导致部分路径失效 - 某些Docker镜像（如
php:apache）默认禁用mod_rewrite，需手动a2enmod rewrite并重启
Composer dump-autoload -o对Web服务器配置没影响，但别漏掉它
composer dump-autoload -o只生成优化后的autoload_static.php，提升类加载速度，但它不改变任何Web服务器行为。很多人以为运行了这个命令就能绕过配置问题，结果发现Class not found照旧。
真正卡住自动加载的，永远是第一步：Web服务器有没有把请求正确交给PHP，以及PHP能不能读到vendor/autoload.php。后续的PSR-4映射、命名空间路径是否匹配，都是第二步的事。
-
dump-autoload -o必须在修改composer.json的autoload字段后执行，否则新配置不生效 - 生产环境务必加
-o（optimize），但开发时可省略，方便调试——因为优化版不支持热更新命名空间映射 - 如果改了
src/目录结构但没运行dump-autoload，即使Web服务器一切正常，也会Class not found
实际部署时，最容易被忽略的是AllowOverride和internal这类底层权限控制——它们不像代码逻辑那样能立刻报错，而是静默地让autoload.php消失在请求链路里。
