根本解法是让接口层依赖PaymentGateway等抽象接口而非Alipay/WechatPay具体类，通过Hyperf DI容器绑定实现、构造函数类型提示注入，并在container.php中用bind明确接口到实现映射，测试时可轻松替换Mock实现。
Hyperf 项目里接口层直接 new 具体实现类、控制器硬编码调用支付网关、服务类构造函数塞满具体类名——这些写法会让测试难、替换难、改一处崩一片。根本解法不是“换个写法”，而是让接口层只依赖 PaymentGateway 这类接口，而不是 Alipay 或 WechatPay。
为什么不能在控制器里 new Alipay()
直接实例化具体类会锁死实现，后续想切微信支付或加 Mock 测试时，必须改控制器代码。Hyperf 的 DI 容器本就支持运行时绑定，绕过它等于放弃框架核心能力。更隐蔽的问题是：一旦 Alipay 构造函数参数变动（比如加了个 $config 参数），所有调用它的控制器全得同步改，耦合被钉死在调用点。
- 控制器里出现
new Alipay()或new WechatPay()是典型 DIP 违反信号 - Hyperf 的
@Inject注解和容器自动解析机制，天然适配接口注入，不用手动 new - 若为兼容旧逻辑临时保留 new，务必抽离到工厂方法，并确保该方法返回的是接口类型，而非具体类
如何正确声明和注入 PaymentGateway 接口
先定义接口，再让具体类实现它，最后在需要的地方通过类型提示注入——这三步缺一不可。Hyperf 会根据类型自动从容器中取对应实现，前提是绑定关系已注册。
- 接口必须用
interface声明，方法签名带完整类型提示（如public function pay(float $amount): bool） - 实现类用
implements PaymentGateway，且必须实现全部方法，否则启动时报Fatal error: Class xxx contains abstract method and must therefore be declared abstract - 在控制器或服务类的构造函数中，直接写
public function __construct(private PaymentGateway $gateway)，Hyperf 自动注入绑定的实现 - 若需多实现共存（如按渠道动态选网关），不要在构造函数硬绑一个，改用
Container::get(PaymentGateway::class)+ 条件判断，或引入策略模式
container.php 里 bind 和 set 的关键区别
Hyperf 启动时读取 config/autoload/container.php，这里写错绑定方式会导致注入失败或返回 null。bind 是接口到实现的映射，set 是抽象名到具体值的注册，二者语义不同，混用会出问题。
- 推荐用
bind(PaymentGateway::class, Alipay::class)—— 明确表达“所有要PaymentGateway的地方，给Alipay” - 避免用
set('payment_gateway', new Alipay())—— 这注册的是字符串键，无法被类型自动解析，只能手动$container->get('payment_gateway') - 若实现类有依赖（如
Alipay需要ConfigInterface），确保其依赖也已正确 bind，否则build()阶段抛ReflectionException - Hyperf 3.1+ 默认启用 PSR-11 兼容，
bind()是最安全、最符合 DI 惯例的方式
测试时怎么换掉真实支付网关
单元测试里不能真调支付宝，但若代码依赖具体类，Mock 就得 patch 方法或重写整个类；而依赖接口时，Mock 只需实现同名方法，Hyperf 容器能无缝切换。
- 测试前用
$this->container->bind(PaymentGateway::class, MockPaymentGateway::class)替换绑定 -
MockPaymentGateway只需 implementsPaymentGateway，pay() 方法返回固定 true/false 即可 - 切记在测试 tearDown 中恢复原绑定，否则污染其他测试用例；Hyperf 提供
afterEach钩子可自动清理 - 如果用了
@Inject注解但没生效，检查是否启用了ScanListener，或类是否在扫描路径内（默认只扫app/）
真正难的不是写 implements 或 bind，而是识别哪些类该抽象、哪些行为该收进接口。比如日志、缓存、HTTP 客户端，只要存在多种实现可能，就值得拉出接口——否则下次加 Redis 缓存时，又得翻出所有 new FileCache() 改一遍。
