service类文件名必须与类名严格一致（含大小写），命名空间须为appservice，路径须为app/service/，且必须执行composer dump-autoload -o更新psr-4映射，否则加载必然失败。
Service类文件名必须与类名完全一致（含大小写）
会，而且影响直接且致命。ThinkPHP 6+ 完全依赖 Composer 的 PSR-4 自动加载，而 PSR-4 规范本身不处理大小写归一化——它把 namespace、路径、类名三者当作严格字符串匹配。Linux 文件系统区分大小写，Windows 虽不区分但 ThinkPHP 内部调用的 realpath()、basename() 等函数仍可能返回大小写不一致的路径，导致自动加载失败。
常见错误现象：Class appserviceUserService not found，但文件明明是 app/service/userservice.php 或 app/service/UserService.php 却命名空间写了 namespace appservice; —— 这时只要文件名是 userservice.php，就一定失败。
- 类名为
UserService→ 文件名必须是UserService.php（首字母大写，无下划线，无后缀 class.php） - 目录名也需匹配：若类在
app/service/Payment/Alipay.php，则命名空间必须是appservicePayment，不能写成appservicepayment - IDE 重命名类时，务必同步改文件名；手动复制粘贴文件后，检查是否生成了隐藏的大小写变体（如 macOS Finder 可能静默保留
UserSevice.php和UserService.php）
命名空间声明错一个字符就加载失败
PSR-4 映射是“前缀→路径”的硬绑定，不支持模糊匹配。比如你在 composer.json 中配置了 "app\service\": "app/service/"，那 Composer 就只认以 appservice 开头的类，并把它映射到 app/service/ 目录下找对应子路径。
所以以下任一情况都会让 new UserService() 报错：
- 命名空间写成
namespace appservice（漏掉末尾反斜杠） - 写成
namespace Appservice（App首字母大写） - 写成
namespace appservices（多了一个s） - 路径实际是
app/services/UserService.php，但 PSR-4 映射没配services，只配了service
运行 composer dump-autoload -o 后，打开 vendor/composer/autoload_psr4.php，搜索 appservice，确认值确实是 array($baseDir . '/app/service') —— 这是唯一可信的映射依据。
为什么 Windows 下有时“看似能用”
不是它真能用，而是文件系统和部分 PHP 函数在 Windows 上做了宽松适配。例如 file_exists('app/service/UserService.php') 和 file_exists('app/service/userservice.php') 都返回 true，但 spl_autoload 触发的 PSR-4 查找逻辑仍按原始类名字符串去拼路径，一旦命名空间或文件名有偏差，Composer 就不会命中映射表。
这种“本地能跑、上线就崩”的问题最危险，因为：
- CI/CD 流水线通常跑在 Linux 容器里，构建阶段就会报
Class not found - 你写的单元测试如果用了
new UserService()，在 Windows 上通过，但在 GitHub Actions 里直接失败 - 部署到生产环境（几乎全是 Linux）时，错误才暴露，且难以复现
Service 类加载失败时该先查什么
别急着翻代码逻辑，优先验证三件事：
- 执行
composer dump-autoload -o（哪怕刚改完）——这是 TP6+ 最常被跳过的步骤 - 用
is_file()替代file_exists()检查类文件是否存在，它对大小写更敏感，能提前暴露问题 - 在控制器里临时加一行：
var_dump(class_exists('appserviceUserService'));，结果为false就说明自动加载根本没走通，不用往下查业务逻辑
真正容易被忽略的是：即使所有命名都对，如果这个 Service 类继承了一个自定义基类（比如 appserviceBaseService），而那个基类的命名空间或文件名有大小写错误，也会连带导致子类加载失败——错误源头往往在“上一层”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
