Yii2项目PHP8环境下特定命名接口提示找不到是什么原因？

运行环境 #

• macOS Big Sur
• MacBook Air M1
• 搭载PHP8的Docker环境

实现代码 #

接口定义 #

interface ClaimStateFeeChargeCollectionSerializerInterface
{
    public function serialize(ClaimStateFeeChargeCollection $collection): string;
}

接口实现类 #

class ClaimStateFeeChargeCollectionSerializer implements ClaimStateFeeChargeCollectionSerializerInterface
{
    // 实现逻辑
}

Yii2组件配置 #

'components' => [
    'collectionUnloadSerializer' => [
            'class' => ClaimStateFeeChargeCollectionSerializer::class
        ]
]

业务调用代码 #

Yii::$app->collectionUnloadSerializer->serialize($collection)

异常表现 #

运行代码时Yii抛出异常，提示ClaimStateFeeChargeCollectionSerializerInterface接口无法找到。将该接口重命名为任意其他名称后，代码即可正常运行。
补充测试验证：PHP7.2环境下该代码无异常，后续测试7.2到8的所有PHP版本，代码均可正常运行，问题已解决。

异常根因分析 #

• 自动加载冲突：macOS默认使用大小写不敏感的文件系统，Docker挂载目录时会继承该特性。PHP8对OPcache预加载、类名合法性校验的逻辑做了调整，如果自动加载索引中存在同名接口缓存、或者接口文件名和类名大小写不匹配，就会触发类找不到的异常。重命名接口后自动加载索引更新，冲突消失，因此恢复正常。
• Yii2容器缓存兼容问题：低于2.0.46版本的Yii2在PHP8环境下，对依赖注入容器的接口-实现类映射缓存处理存在兼容缺陷，如果之前已经注册过同名接口的映射关系，缓存未清理时就会判定接口未找到。重命名接口后容器会生成新的映射记录，因此运行正常。
• PHP8名称解析规则变更：PHP8对命名空间下的同类名（类/接口/trait）重复定义检测更严格，如果代码中存在不同命名空间下的同名接口，且use导入时未显式指定完整命名空间，PHP8会优先判定为未定义，而PHP7的名称检测逻辑更宽松，不会抛出异常。

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