在 Symfony 7.1 中需用 Yansongda Pay v4.0 快速构建生产级支付宝支付接口，通过 PEM 私钥、JSON 环境配置、封装 AlipayService 服务类及严格验签的 notify 路由实现安全支付与回调。
在 Symfony 7.1 应用中快速创建可上线的支付宝支付接口，需绕过官方 SDK 的繁琐签名逻辑、避免硬编码密钥、确保回调验签可靠且不被伪造——这些不是可选项，而是必须一步到位的生产级要求。
安装 Yansongda Pay 并配置基础服务
Yansongda/pay 是当前 Symfony 生态中最稳定、文档最全、维护最活跃的通用支付 SDK，原生支持 Symfony 7.1 的依赖注入与配置机制，比 Omnipay 更轻量、更贴近支付宝最新 API（v3）规范。
执行命令安装：
composer require yansongda/pay:^4.0
该版本已适配 PHP 8.2+ 和 Symfony 7.1 的新式服务定义语法，【不要安装 ^3.x 版本，它不兼容 Symfony 7.1 的自动配置机制】。
若项目未启用 Symfony Flex 的 auto-configuration，请手动注册服务：在 config/services.yaml 中添加：
YansongdaPayPay::class:
arguments:
- '%env(json:ALIPAY_CONFIG)%'
准备支付宝密钥与配置参数
登录支付宝开放平台 → 进入「我的应用」→ 找到目标应用 →「开发信息」页复制 AppID；「密钥管理」页下载「应用私钥（PKCS#1）」并转为 PEM 格式（不可用 PKCS#8），同时获取「支付宝公钥」。
将私钥内容（含 BEGIN/END 块）保存为 config/alipay_private_key.pem，确保文件权限为 600，且不在 web 可访问路径下。
在 .env 文件中写入 JSON 格式配置：
ALIPAY_CONFIG='{"app_id":"2021000123456789","merchant_private_key":"-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAu...\n-----END RSA PRIVATE KEY-----","alipay_public_key":"-----BEGIN PUBLIC KEY-----\nMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...\n-----END PUBLIC KEY-----","notify_url":"https://yourdomain.com/pay/alipay/notify","return_url":"https://yourdomain.com/pay/alipay/return","log":{"file":"/var/log/symfony/alipay.log","level":"debug"}}'
注意：notify_url 和 return_url 必须与支付宝后台填写的完全一致，域名、协议、路径、结尾斜杠均需严格匹配，否则验签失败。
编写支付网关服务类
创建 src/Service/AlipayService.php：
这一步不能跳过——直接在控制器里调用 Pay::alipay() 会导致无法单元测试、无法复用、无法统一处理异常和日志。
代码开头声明命名空间和 use 语句后，定义构造函数：
public function __construct(private readonly LoggerInterface $logger) {}
在 generatePayLink() 方法中，先构建订单参数：
$order = [
'out_trade_no' => (string) $orderId,
'subject' => $subject,
'total_amount' => number_format($amount, 2, '.', ''),
'product_code' => 'FAST_INSTANT_TRADE_PAY'
];
然后调用 SDK：
return Pay::alipay($this->getConfig())->wap($order);
返回的是一个 SymfonyComponentHttpFoundationRedirectResponse 对象，可直接从控制器 return 它，无需手动拼 URL 或输出 form 表单。
注册回调路由并实现通知处理
在 config/routes.yaml 中添加：
alipay_notify:
path: /pay/alipay/notify
controller: AppControllerPaymentController::alipayNotify
methods: [POST]
在控制器中编写 alipayNotify 方法：
第一步：接收原始 POST 数据（不是 $_POST）：
$content = file_get_contents('php://input');
第二步：交给 SDK 验签并解析：
$data = Pay::alipay($this->alipayConfig)->verify($content);
第三步：检查 trade_status 是否为 TRADE_SUCCESS：
if ('TRADE_SUCCESS' !== $data['trade_status']) {
return new Response('fail', 200);
}
第四步：查本地订单是否存在、是否已支付，若未支付则更新状态并触发发货等后续流程；
第五步：返回字符串 'success'（注意是小写，无空格、无换行、无 XML/JSON 封装）。
【必须返回纯文本 success，且 HTTP 状态码为 200，否则支付宝会持续重发通知】
