class_already_exists 不是 PHP 的标准错误信息，真实报错通常是 Fatal error: Cannot declare class X: because the name is already used 或类似提示。根本原因不是“文件被包含多次”，而是同一个类被定义了两次——PHP 不允许重复定义类。
为什么 require/include 多次会触发这个错误
PHP 的 require 和 include 是无条件执行的：只要执行到，就解析并执行文件内容。如果该文件里有 class MyClass { ... }，第二次加载时就会试图再次声明同名类，直接报致命错误。
- 常见于手动写
require 'User.php';又没加守卫逻辑 - 框架外自己搭结构时，把类文件放在公共引入文件（如
config.php）里，又被多个入口重复载入 - 在循环或条件分支中不加判断地
require同一个类文件
class_exists() 不能代替 require_once
class_exists() 只检查类是否已定义，它本身**不会加载类文件**（除非第二个参数为 true 且启用了自动加载）。所以你不能这样写：
if (!class_exists('User')) {
require 'User.php'; // ❌ 错误假设：class_exists() 能帮你“跳过已加载”
}
这段代码的问题在于：User.php 里可能还定义了其他类、函数或执行了副作用代码（如注册路由、初始化配置），只靠 class_exists() 判断无法保证这些逻辑不重复执行。真正该用的是 require_once 或 include_once。
立即学习“PHP免费学习笔记（深入）”；
autoload 机制下为何还会出现重复定义
即使用了 spl_autoload_register()，也可能因以下原因导致类被多次加载：
- 多个 autoload 函数都匹配到了同一个类名（比如两个函数都尝试
include $class . '.php'） - 某个 autoload 函数里用了
require而非require_once - 手动
require了类文件，又触发了 autoload（例如先require 'User.php'，再调用new User()） - Composer 的 PSR-4 映射和手写 autoload 共存，路径重叠（如
"App\": "app/"和"App\": "src/"都注册了）
最稳妥的解决方式
不要依赖 class_exists() 做加载控制，也不要混用多种加载方式。统一按场景选择：
- 明确知道路径且无命名空间：用
require_once 'path/to/MyClass.php'; - 使用 Composer 管理依赖：删掉所有手动
require，只靠composer dump-autoload -o生成优化映射，然后靠new MyClass()触发 autoload - 必须手写 autoload：函数体内必须用
require_once，并在加载前加class_exists($class, false)守卫（false表示不触发 autoload，避免递归）
真正的难点不在“怎么写”，而在于项目中加载路径是否收敛、是否有人绕过规范直接 require —— 这类问题往往藏在老代码或临时调试片段里，不容易一眼发现。
