为什么spl_autoload_register()函数无法正常执行回调函数

• 未触发类加载场景
  spl_autoload_register注册的回调仅会在代码尝试使用未被定义或手动引入的类、接口、Trait、枚举时才会执行。如果代码中没有对未知类的实例化、继承、静态方法调用、类常量访问、类型判断等操作，回调不会被触发。
  示例代码（回调不会执行的场景）：

spl_autoload_register(function ($className) {
    echo '自动加载被触发';
});
// 此处没有调用任何未加载的类，上述回调永远不会执行

• 目标类已被提前加载
  如果在调用spl_autoload_register之前，目标类已经通过require/include手动引入，或者被更早注册的其他自动加载器加载完成，后续注册的回调不会被触发。
• 回调参数不合法
  1. 传入的可调用结构错误：比如传入类方法作为回调时，方法为非public权限、类名/方法名拼写错误，回调本身就是不可执行的结构
     错误示例：

  class Autoloader {
      // 私有方法无法作为公开回调被调用
      private function loadClass($className) {}
  }
  // 回调不合法，不会生效也不会默认抛出报错
  spl_autoload_register([Autoloader::class, 'loadClass'], false);
  

  2. 注册时设置了$throw = false参数，回调不合法时不会抛出错误提示，无法感知注册失败
• 命名空间匹配偏差
  如果使用的类带命名空间，自动加载回调收到的$className参数会是完整命名空间拼接的类名，若加载逻辑仅匹配短类名会找不到文件，容易被误判为回调未触发。可以在回调第一行加var_dump($className);exit;确认回调是否真的未执行。
• 预加载配置导致类提前加载
  PHP配置开启opcache预加载（preloading）后，若目标类在服务启动的预加载阶段就被加载，运行时不会再触发自动加载回调。
• 反序列化场景未开启类加载权限
  使用unserialize反序列化未知类时，PHP默认不会触发自动加载，需要显式设置unserialize的allowed_classes参数为true才会触发对应类的加载逻辑。

内容的提问来源于stack exchange，提问作者Rodrigo Silva