PHP 8.3 加 #[Override] 后父类方法一改名 上线直接报 Fatal error

升级到 PHP 8.3 之后,我给服务层的方法批量加了 #[\Override],想靠它兜住父类改名。上线十分钟,订单接口 500,日志原文是 OrderServiCe::markPaid() has #[\Override] attribute, but no matching parent method exists。

第一反应是注解写错了位置,检查了三遍,语法没问题。真正的原因在上一版重构:父类 BaseOrder 的 markPaid 改名成了 markPaidAt,子类重写的方法没跟着改,加上注解之后编译期直接报致命错误。

#[\Override] 是 8.3 才有的,它只做一件事,检查当前方法在父类或接口里有没有同名方法。没有就 Fatal error,整个文件编译不过。它不看参数签名,父类把参数类型改了它也不管。

试过把注解删掉,接口立刻恢复,但重构漏改的问题又回到运行时。这次只是静默走到父类默认实现,退款金额算错,比 500 更难发现。

最终按报错列表改了四个方法名,另外两个父类方法保留旧名并标了 @deprecated。CI 里加了一步 php -l 全量检查,编译不过直接拦住,不给发布。

class BaseOrder
{
    public function markPaidAt(): void {}
}

class OrderService extends BaseOrder
{
    #[\Override]
    public function markPaidAt(): void {}
}

验证是本地跑一遍全量 lint,再在预发环境把六个核心接口请求一遍。上线后一周没有再出现 Override 相关的 500,日志里那条报错也没再刷。

您可以还会对下面的文章感兴趣: