Hyperf环绕通知无法修改方法参数，因process()不接受参数且参数已固化；但可修改返回值，只需调用process()后return新值即可。
Hyperf切面中如何在环绕通知里修改方法参数
Hyperf 的 ProceedingJoinPoint 不支持直接“替换”原始方法调用时传入的参数数组（比如像 Spring 那样用 proceed(Object[] args) 重传），它只提供 $proceedingJoinPoint->process() 无参调用。所以想改参数，必须在调用前「偷偷替换目标对象的属性」或「劫持方法内部对参数的读取逻辑」——但这两者都违背 AOP 原则，也不可靠。
更实际的做法是：把参数修改逻辑前置到业务层，或用注解+切面组合实现语义级参数转换。例如：
- 定义一个
@ValidateAndTransform注解，标注在 Controller 方法上； - 切面类中通过
$proceedingJoinPoint->getArguments()读出原始参数； - 根据注解配置（如
trim=true、toInt=true）做类型/值转换； -
不调用
process()，而是反射调用目标方法并传入新参数数组 —— 但这会绕过 DI 容器和代理链，高风险，不推荐；
真正安全可控的方式只有一种：
- 在切面里不做参数篡改，而是把转换逻辑下沉到 Service 层入口，或用 DTO + 自动映射（如
Hyperf/Validator+Hyperf/Contract/NormalizerInterface）统一处理。
常见错误现象：ArgumentCountError 或参数值没变化，本质是因为误以为 process() 接受参数；Hyperf 的 process() 是 void 调用，参数已固化在代理对象中，无法 runtime 替换。
Hyperf环绕通知能否修改返回值？怎么写才生效
能，而且方式比 Spring 更直接：只要在 process() 调用后拿到返回值，然后 return 你自己的值即可。Hyperf 的代理机制会原样透出这个 return 值，调用方完全感知不到。
关键点在于：
- 必须调用
$proceedingJoinPoint->process()，否则目标方法不执行； - 返回值类型需与原方法声明一致（PHP 弱类型下虽不报错，但 JSON 序列化或 IDE 提示可能出问题）；
- 若原方法返回
null，而你返回['code'=>0]，那前端收到的就是后者；
public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
$result = $proceedingJoinPoint->process();
// 修改返回结构
if (is_array($result) && !isset($result['timestamp'])) {
$result['timestamp'] = time();
}
return $result;
}注意：如果原方法返回的是对象实例（如 User），你返回一个数组，就等于彻底替换了类型。PHP 不会自动 cast，调用方代码若依赖该对象方法，就会 fatal error。
为什么加了切面但返回值没变？检查这三点
切面写了、注解也打了、缓存清了，结果还是原样返回？大概率卡在这几个地方：
-
$annotations数组里写的注解类名不对，比如写成'Trace'而不是App\Annotation\Trace::class； - 切面类没加
#[Aspect]，或者命名空间没导入，导致容器没注册该切面； - 目标方法所在类没被 AOP 扫描到：检查
config/autoload/annotations.php的scan配置是否包含该类路径，比如漏了App\Controller*；
性能影响：每次调用都会触发切面逻辑，如果 process() 里做了 heavy I/O（如写日志到文件、远程调用），会显著拖慢接口。建议耗时操作异步化，或用 co::sleep(0) 让出协程。
Hyperf AOP 中修改返回值最易忽略的兼容性陷阱
Hyperf 默认使用 hyperf/aop 的代理生成器，但它对 PHP 8.2+ 的只读属性（public readonly string $id）和构造器属性提升（public function __construct(public string $name)）支持不完整。如果你在返回对象里用了这些特性，又在切面中尝试 json_encode($result)，可能触发 ReflectionException 或静默失败。
更隐蔽的问题是：当目标方法返回一个带魔术方法（<strong>toString</strong>、get）的对象，而你在切面里做了 array_merge((array)$result, [...])，会导致属性丢失或不可预测行为。
所以，与其在切面里硬改返回值，不如让业务方法自己返回标准数组，或统一用 Hyperf\HttpMessage\Stream\SwooleStream 等可序列化类型 —— 这些才是 Hyperf AOP 真正友好、稳定、可维护的落点。
