Linux服务器PHP文件路径大小写敏感导致404，因文件系统区分大小写而PHP脚本不区分；需统一小写命名、用ls/find比对、避免重写规则掩盖问题。
Linux服务器上PHP文件路径大小写敏感导致404
PHP脚本本身不区分大小写，但Linux文件系统默认区分大小写。访问 /index.php 和 /Index.php 是两个完全不同的路径，后者在文件实际为 index.php 时必然返回404。
- Apache/Nginx 日志里看到
File does not exist: /var/www/html/Index.php这类错误，基本可确认是大小写问题 - 本地Windows/Mac开发时能跑通，一上Linux服务器就404，90%是这个原因
- 不要依赖重写规则“自动修正”——那只是掩盖问题，反而让路径逻辑更混乱
快速定位大小写不匹配的三种方法
别靠猜，用命令直接比对请求路径和真实文件名：
- 用
curl -I http://yoursite.com/About.php看是否返回404，再执行ls -l /var/www/html/查看实际文件名是about.php还是About.php - 在PHP中临时加一行：
echo __FILE__;
，访问页面看输出的绝对路径，和你写的include或 URL 中的路径逐字符比对 - 用
find /var/www/html -iname "about.php" -print（-iname忽略大小写查找），确认文件存在但命名不一致
include/require 路径大小写写错也报404或Warning
include 和 require 加载的是文件系统路径，不是URL，同样受Linux大小写限制。错误不会显示“找不到页面”，而是PHP警告+可能的白屏：
- 错误信息类似：
Warning: include(Header.php): failed to open stream: No such file or directory - 检查
include('Header.php');—— 如果真实文件是header.php，就必须改成小写 - 用
file_exists('Header.php')在代码里调试，返回false就说明路径不匹配 - 避免硬编码路径，改用
__DIR__ . '/header.php'，既安全又明确
Nginx/Apache配置无法绕过文件系统大小写限制
有人想用 rewrite 把所有请求转成小写，但这是危险操作：URL语义会丢失，上传的图片名、API参数里的大小写都可能被强制转换。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 的
map+try_files方案极难覆盖全部情况，且性能下降明显 - Apache 的
mod_speling模块虽能容错，但默认关闭，开启后可能引发重定向循环或误匹配 - 最稳妥的做法：统一约定项目内所有PHP文件名全小写（如
user_login.php），并在CI流程中用find . -name "*[A-Z]*.php"检查
ls -R | grep ".php" 扫一遍命名风格，比出问题后再翻日志快得多。 
