PSR-4自动加载失效主因是命名空间声明位置错误或路径映射不匹配：namespace必须紧贴<?php后无空行/注释；composer.json中前缀须双反斜杠结尾、路径须正斜杠结尾；大小写与文件名必须完全一致。
PSR-4 自动加载本身不随 PHP 版本变化而失效，所谓“PHP 版本兼容性问题”绝大多数其实是命名空间与路径映射在不同环境下的行为差异被误判为版本冲突。真正出问题的，是开发者在写法上踩中了跨版本更敏感的几个硬性规则。
namespace 声明位置必须严格紧贴
PHP 5.3 引入命名空间后，对声明位置的要求就非常苛刻：它必须是文件中除 declare() 外的第一条语句。任何空行、BOM 字符、注释或输出都会导致 namespace 被忽略，整个文件退化到全局空间。
- 错误写法（开头有空行或注释）：
<?php
namespace AppControllers; - 正确写法：
<?php
namespace AppControllers; - 后果：类虽存在，但自动加载器按 AppControllersUserController 去找，而实际类被注册在 UserController 下，必然 Class not found
PSR-4 映射配置中的反斜杠必须双写（JSON 转义）
composer.json 是 JSON 格式，单个反斜杠会被解析为转义字符。若写成 "App": "src/"，实际只保留一个 ，导致前缀变成 App" —— 这不是 PHP 版本问题，而是 JSON 解析规则在所有 PHP 版本下都一致。
- ✅ 正确配置：
"autoload": {
"psr-4": {
"App\": "src/"
}
} - ❌ 错误配置：
"App": "src/" 或 "App": "src/" - 验证方式：运行 composer dump-autoload -v，看输出中是否列出 App 及其对应路径
动态类名不继承当前命名空间，必须用 FQCN
在方法里拼字符串创建对象（如 $class = "FormElementRadio"; new $class();），PHP 不会把当前命名空间或 use 声明带进去。这个行为从 PHP 5.3 到 8.3 完全一致，不是兼容性问题，而是设计如此。
立即学习“PHP免费学习笔记（深入）”；
- 错误做法：
use ElementsFormElementRadio;
// …
$class = "FormElementRadio";
new $class(); // → 尝试实例化全局空间下的 FormElementRadio - 正确做法（任选其一）：
• 硬编码前缀：$class = "Elements\FormElement{$type}";
• 用魔术常量：$class = __NAMESPACE__ . "\FormElement{$type}";
大小写敏感性在不同系统表现不一，但 PSR-4 规范要求严格一致
Linux/macOS 文件系统区分大小写，Windows 默认不区分。一个类名写成 Usercontroller.php，命名空间却是 AppControllersUserController，在 Windows 开发时可能“碰巧能跑”，部署到 Linux 就报错。
- 类文件名必须与类名逐字母完全一致，包括大小写
- 命名空间中的每一级也必须与目录名大小写一致，例如 Controllers ≠ controllers
- 建议开发阶段就使用 Linux 容器或 WSL，避免“本地能跑线上炸”的陷阱
