Hyperf绑定异常处理类时抛出语法级错误，根本原因是PHP版本低于8.1或注解类误用Attribute语法——前者导致Parse error: unexpected token "["，后者因将普通ExceptionHandler类当作注解类扫描或错误添加#[Attribute]声明所致。
Hyperf绑定异常处理类时抛出语法级错误，基本可以确定不是逻辑问题，而是 PHP 解析阶段就失败了——这类报错通常出现在启动、加载配置或反射注解时，根本没走到运行期。
核心原因只有两个：PHP 版本不达标，或注解类定义不符合 PHP 8+ Attribute 规范。
PHP 版本未达 8.1+，Attribute 语法直接解析失败
Hyperf 3.x 全面弃用 @Annotation 风格，强制使用 #[Attribute] 语法。PHP 8.0 及以下版本不支持该语法，会直接报 Parse error: syntax error, unexpected token "["。
- 运行
php -v和php-fpm -v（若用 FPM），确认 CLI 和 Web SAPI 均为 PHP 8.1.0 或更高版本 - 若版本低于 8.1，升级 PHP 是唯一解；降级 Hyperf 不推荐，且 2.2 已停止维护
自定义异常处理器类被误当注解类加载
常见于把 ExceptionHandler 类放在 app/Annotation/ 目录下，或在 config/autoload/annotations.php 中错误扫描了该路径。
- 检查
config/autoload/annotations.php的scan.paths是否包含app/Exception/Handler或类似非注解目录 - 注解类必须满足：
- 命名空间与文件路径严格匹配
- 类顶部有
use Attribute; - 类声明为
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)] -
不继承
AbstractAnnotation（v3 已移除）
- 如果你只是写了个普通
App\Exception\Handler\CustomExceptionHandler，它就不该带#[Attribute]，也不该被 annotation 扫描器加载
exceptions.php 配置中 handler 键名与 server name 不一致（但此问题不触发语法错误）
注意：这个错误会导致验证失败无 errors 字段、异常不被捕获等运行时问题，但不会引发 Parse error。如果看到的是语法报错，先排除它。
其他典型语法级诱因
- 文件末尾有多余 BOM 或不可见控制字符（尤其 Windows 编辑器保存后）
-
exceptions.php中用了中文引号“”或全角冒号：，导致数组语法非法 - 自定义 Handler 类里用了 PHP 8.1+ 新特性（如
enum、never类型），但实际运行环境 PHP 版本更低
// ❌ 错误示例：PHP 8.0 下无法解析
#[Attribute(Attribute::TARGET_CLASS)]
class MyExceptionHandler extends ExceptionHandler { }
// ✅ 正确前提：PHP >= 8.1，且 use Attribute; 已声明不复杂但容易忽略
