PHP 8.2 不支持 #[Override]，会直接报 Parse error: syntax error, unexpected token "["；该注解仅 PHP 8.3+ 支持，且为编译期强制校验，要求子类方法严格匹配父类或接口中同名、签名兼容的方法。
![php8.2#[\override] 属性校验失败，子类方法签名不匹配如何排查](https://img.php.cn/upload/article/001/503/042/179101150811080.png)
PHP 8.2 根本不支持 #[Override]，写了就报 Parse error
PHP 8.2 解析器完全不认识 #[Override] 语法，不是警告，是硬性解析失败。只要代码里出现这个注解，php -l 或 FPM 启动时就会直接报：Parse error: syntax error, unexpected token "["。
这意味着你看到的“校验失败”根本不是运行时方法签名问题，而是连类都没加载成功。常见诱因包括：
- 开发环境 PHP 8.3+ 写了
#[Override]，但部署到 PHP 8.2 服务器上没删干净 - CI/CD 流水线混用多版本 PHP，某一步用了 8.3 编译，另一步用 8.2 运行
- 宝塔或面板里显示“PHP 版本已切换”，但实际 php-fpm 进程仍跑在旧版本（比如
systemctl status php-fpm-82显示 inactive）
PHP 8.3+ 下 method.override 错误：方法名或参数列表不匹配
升级到 PHP 8.3 后，#[Override] 开始生效，但 PHPStan 或运行时会报 method.override 错误，典型提示是：Method Foo::bar() has #[Override] attribute but does not override any method.
这说明子类方法在签名层面没对齐父类或接口——不是“看起来像”，而是必须严格一致。重点排查：
立即学习“PHP免费学习笔记（深入）”；
-
foo(string $a, int $b)vsfoo(String $a, int $b)：类型名大小写不敏感，但String是类名，string是内置类型，二者不等价 - 参数顺序错位，比如父类是
function handle($id, $data)，子类写成function handle($data, $id) - 遗漏可选参数默认值：父类
function run($x = null)，子类function run($x)（无默认值）→ 签名不兼容 - 父类方法是
private或来自trait：#[Override] 只检查extends和implements链，use的 trait 方法不算“被覆盖”
父类方法被删或重命名后，#[Override] 让部署立刻失败
这是 #[Override] 最典型的“提前暴露问题”场景：父类重构删掉了 tearDown()，子类忘了同步删掉 #[Override] 注解，一上线就 Fatal Error。
这种错误不会静默跳过，它强制你面对继承契约的变更。应对方式很实在：
- 搜索整个项目所有
#[Override]，逐个确认对应父类/接口中是否还存在同名方法 - 对框架钩子方法（如
setUp()、boot()、register()）加注前，先查清该框架当前版本的基类定义 - CI 中启用
opcache.enable_cli=1，让php -r "class_exists('YourClass');"在类加载阶段就触发校验，别等到请求进来才崩
为什么 IDE 跳转到定义看起来没问题，但还是报错？
IDE 常常只看当前文件或缓存的符号表，而 #[Override] 校验发生在 PHP 引擎加载类时，依赖的是真实继承链和完整类型声明。容易忽略的点：
- 父类本身用了
declare(strict_types=1)，但子类没加 → 参数类型检查实际未启用，签名看似一致，实则运行时行为不同 - 父类方法返回类型是泛型，比如
function get(): Collection<User>，子类写function get(): array→ 类型不兼容，#[Override] 拒绝 - 父类在接口中声明方法，但子类实现时没写
implements ThatInterface，只靠 extends 父类间接获得 → #[Override] 不认，必须显式 implements
真正可靠的验证方式永远是：在目标 PHP 版本下执行 php -l 文件名.php，而不是依赖 IDE 高亮或静态分析缓存。
