linux下thinkphp因文件系统大小写敏感导致class not found：windows开发时命名不规范（如user.php）可运行，linux则失败；需确保类名与文件名首字母大写一致、use语句路径小写且匹配目录结构，并清除缓存、检查composer autoload配置及模板路径大小写。
Linux下ThinkPHP报错Class not found：大小写敏感导致的自动加载失败
Linux文件系统默认区分大小写，而Windows不区分——这是绝大多数ThinkPHP项目上线后首次报错的根源。当你在Windows开发时写了 use appcontrollerUser;，但实际类文件是 User.php，而你误命名为 user.php，Windows能加载成功，Linux直接抛出 Class 'appcontrollerUser' not found。
关键不是“有没有命名规范”，而是“自动加载器按命名空间查文件时，路径拼接结果必须与真实文件名完全一致（含大小写）”。ThinkPHP 5.1+ 使用 PSR-4 自动加载，规则是：appcontrollerUser → app/controller/User.php；若文件实际为 user.php，就找不到。
- 检查所有
app/下控制器、模型、服务类的文件名：首字母必须大写，与类名严格一致（如类User→ 文件User.php） - 检查
use语句中的命名空间路径：全部小写，斜杠用反斜杠，且与目录结构一一对应（appserviceUserService对应app/service/UserService.php） - 运行
php think clear:route和php think clear:config清除缓存，避免旧映射干扰
vendor/autoload.php 加载失败或类映射错乱
ThinkPHP 的自动加载依赖 Composer 生成的 vendor/autoload.php，而它内部的 PSR-4 映射表是在 composer.json 中定义的。如果你手动改过 psr-4 配置，或把 app 目录移到了非标准位置（比如改成 src），就会导致自动加载路径错位。
典型现象：本地没问题，部署到 Linux 后部分类突然无法解析，且错误不指向具体文件，而是卡在 ClassLoader::loadClass()。
- 确认
composer.json中autoload.psr-4的配置是否仍为"app\": "app/"（注意双反斜杠转义） - 不要在 Linux 上用
cp -r复制 Windows 下的整个项目后直接运行——复制过程可能静默丢弃大小写差异（如把User.php和user.php覆盖成一个），建议用rsync -avz或重新git clone - 执行
composer dump-autoload -o强制重生成优化后的自动加载映射（尤其当增删过类文件后）
模板中 import、extend、include 路径大小写错误
ThinkPHP 模板引擎本身不校验路径大小写，但 Linux 下 {include file="public/header"} 实际会尝试加载 template/public/header.html。如果真实路径是 Template/Public/Header.html，就会报 Warning: include(): Failed opening ...。
这类问题不会触发 PHP Fatal Error，容易被忽略，但页面直接白屏或缺失区块。
- 统一模板路径全部小写：目录名和文件名都用小写（如
template/public/header.html），避免任何驼峰或大写 - 禁用模板编译缓存调试期：在
config/template.php中设'cache' => false，否则修改了文件名但缓存还在用旧路径 - 检查
view_replace_str配置项是否意外替换了路径字符串（例如把/Public/替成/public/后又反向替换出错）
Linux下 Runtime 目录权限与路径硬编码隐患
有些老项目在代码里写了类似 file_get_contents('./Runtime/xxx.json') 这种相对路径，或在配置中写死 __ROOT__/runtime/。Linux 下当前工作目录（getcwd()）可能不是项目根目录（比如通过 crontab 或 systemd 启动），导致路径拼错；同时 Runtime 目录若权限不足（如 www-data 无写入权），日志、缓存、模板编译全挂。
这不是大小写问题，但常和大小写报错一起出现，掩盖真正原因。
- 绝对不用
./或../在运行时拼路径，一律用 ThinkPHP 内置常量：RUNTIME_PATH、APP_PATH、ROOT_PATH - 部署后立刻执行：
chmod -R 755 runtime/和chown -R www-data:www-data runtime/（根据实际 Web 用户调整） - 检查
runtime/下子目录是否存在且可写：尤其是log/、cache/、temp/，缺失任一都会让框架静默降级或报错
最麻烦的不是改错，而是大小写问题往往藏在第三层依赖里——比如某个 Composer 包的类引用了 UtilsStr，但它自己的文件叫 str.php。这种时候得进 vendor/ 里翻源码，而不是只盯自己写的 app/ 目录。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
