recyc/fengketrade

Fork 0

mirror of https://gitee.com/liuxioabin/fengketrade.git synced 2026-04-17 12:57:32 +08:00

Billy eee44f2816 bug修复

2025-10-20 15:29:15 +08:00

15 KiB

Raw Blame History

建行支付对接修复报告

项目: Shopro商城建行支付集成 修复时间: 2025-01-20 文档版本: v2.0 (修订版) 建行接口版本: v2.20 (2025-07-25)

⚠️ 重要修订说明

本报告v2.0版本修正了v1.0中关于"建行平台公钥"的严重错误理解:

❌ 错误: 文档中不存在"建行平台公钥"这个概念
✅ 正确: 应该是"建行生活支付验签公钥"(需联系建行生活技术支持获取)

📋 修复概览

本次对建行支付对接代码进行了5项严重错误修复和1项性能优化,基于建行官方Java示例代码和接口文档v2.20规范。

修复文件清单

文件路径	修复项	风险等级
`addons/shopro/library/ccblife/CcbPaymentService.php`	MAC签名算法、SIGN验签逻辑	🔴 致命
`addons/shopro/library/ccblife/CcbEncryption.php`	ENCPUB生成、RSA分段加密	🔴 致命
`addons/shopro/controller/Ccbpayment.php`	防重复支付、notify返回格式	🟡 严重

🔴 致命错误修复

1. 支付串MAC签名算法错误

位置: CcbPaymentService.php:148-153

修复前 ❌

// 错误: 使用私钥签名
$mac = md5($signString . $this->config['private_key']);

修复后 ✅

// 正确: 使用服务方公钥参与MD5计算(建行v2.2规范)
$platformPubKey = $this->config['public_key']; // 服务方公钥
$mac = strtoupper(md5($signString . '&PLATFORMPUB=' . $platformPubKey));

技术说明

根据建行文档v2.2版本和官方MD5Util.java示例:

PLATFORMPUB字段: 仅参与MD5摘要计算,不作为HTTP参数传递
签名格式: MD5(参数串 + &PLATFORMPUB= + 服务方公钥内容)
输出格式: 32位大写MD5字符串 (对照MD5Util.java第30行: toUpperCase())

影响: 修复前建行会拒绝所有支付请求,因签名验证100%失败。

2. ENCPUB字段生成逻辑错误

位置: CcbEncryption.php:387-420

修复前 ❌

// 错误: 加密整个商户公钥
return $this->rsaEncrypt($this->publicKey);

修复后 ✅

// 正确: 只加密商户公钥后30位
$publicKeyContent = str_replace([
    '-----BEGIN PUBLIC KEY-----',
    '-----END PUBLIC KEY-----',
    "\r", "\n", " "
], '', $this->publicKey);

$last30Chars = substr($publicKeyContent, -30);
return $this->rsaEncrypt($last30Chars);

技术说明

建行文档明确要求:

"使用服务方公钥对商户公钥后30位进行RSA加密并base64后的密文"

影响: 修复前ENCPUB字段内容错误,可能导致建行无法验证商户公钥。

3. 异步通知SIGN验签逻辑优化

位置: CcbPaymentService.php:467-570

修复前 ❌

// 错误: 使用MD5验签
$expectedSign = md5($signStr . $this->config['private_key']);
return strtolower($signature) === strtolower($expectedSign);

修复后 ✅

// 智能验签方案: 如果配置了验签公钥则使用RSA,否则降级为POSID验证
$ccbVerifyPublicKey = $this->config['ccb_payment_verify_public_key'] ?? '';

if (empty($ccbVerifyPublicKey)) {
    // 降级方案: POSID验证
    return ($params['POSID'] ?? '') === $this->config['pos_id'];
}

// 完整方案: RSA验签(尝试SHA256和SHA1)
$signBinary = hex2bin($params['SIGN']);
$pubKey = openssl_pkey_get_public($ccbVerifyPublicKey);

$result = openssl_verify($signStr, $signBinary, $pubKey, OPENSSL_ALGO_SHA256);
if ($result !== 1) {
    $result = openssl_verify($signStr, $signBinary, $pubKey, OPENSSL_ALGO_SHA1);
}

return $result === 1;

技术说明

根据建行文档7.2.3章节:

SIGN字段: 256个十六进制字符 (2048位RSA签名)
验签密钥: "建行生活分配的服务商支付验签公钥" (NT_TYPE=YS时)
验签算法: RSA-SHA256或SHA1 (文档未明确,代码会自动尝试)
获取方式: 联系建行生活平台技术支持

降级方案说明

由于建行未提供验签公钥和示例代码,代码实现了两级验证:

优先: 如果配置了ccb_payment_verify_public_key,使用RSA验签
降级: 如果未配置,验证POSID和订单号是否匹配

建议: 尽快联系建行技术支持获取验签公钥,补全配置后获得完整安全保障。

影响: 修复后验签逻辑更健壮,未配置公钥时也能正常运行(安全性降低但不会中断业务)。

🟡 严重问题修复

4. 订单状态更新缺少防重复逻辑

位置: Ccbpayment.php:170-197

修复前 ❌

// 直接更新,没有并发控制
$order->status = 'paid';
$order->save();

修复后 ✅

// 使用原子性更新,防止并发重复支付
$affectedRows = Db::name('shopro_order')
    ->where('id', $order->id)
    ->where('status', 'unpaid') // 只更新未支付的订单
    ->update([
        'status' => 'paid',
        'paid_time' => time() * 1000,
        'updatetime' => time()
    ]);

if ($affectedRows === 0) {
    // 订单已支付或状态异常
    throw new Exception('订单状态异常,无法更新为已支付');
}

影响: 修复前在高并发场景下可能出现重复支付或状态覆盖。

5. notify接口返回格式不规范

位置: Ccbpayment.php:271-283

修复前 ❌

// ThinkPHP框架会追加额外内容
echo $result; // 'SUCCESS' 或 'FAIL'

修复后 ✅

// 直接exit,确保只返回纯文本
exit(strtoupper($result)); // 'SUCCESS' 或 'FAIL'

技术说明

建行要求异步通知响应:

HTTP 200 状态码
纯文本 响应体: SUCCESS 或 FAIL
不允许任何额外字符(HTML/JSON等)

影响: 修复前ThinkPHP框架可能追加调试信息,导致建行认为通知失败并重复推送。

⚡ 性能优化

6. RSA加密分段大小动态计算

位置: CcbEncryption.php:102-129

优化前 ⚠️

// 写死1024位RSA的chunk size
$chunkSize = 117; // 1024位RSA密钥,每次最多加密117字节

优化后 ✅

// 动态获取RSA密钥大小
$keyDetails = openssl_pkey_get_details($pubKeyId);
$keySize = $keyDetails['bits'] / 8; // 1024位=128字节, 2048位=256字节
$chunkSize = $keySize - 11; // PKCS1填充需要预留11字节

优势:

自动适配1024位/2048位/4096位RSA密钥
减少不必要的分段次数,提升加密性能
避免密钥升级后的兼容性问题

🔐 建行接口签名规则总结

支付串生成流程

graph LR
    A[34个参数] --> B[按ASCII排序ksort]
    B --> C[http_build_query拼接]
    C --> D[追加&PLATFORMPUB=服务方公钥]
    D --> E[MD5签名,32位小写]
    E --> F[ENCPUB=RSA加密商户公钥后30位]
    F --> G[最终支付串=参数+MAC+PLATFORMID+ENCPUB]

异步通知验签流程

graph LR
    A[接收SIGN字段] --> B[hex2bin转二进制]
    B --> C[移除SIGN,剩余参数ksort排序]
    C --> D[拼接签名原串]
    D --> E[使用建行公钥RSA-SHA256验签]
    E --> F{验签结果}
    F -->|成功| G[返回SUCCESS]
    F -->|失败| H[返回FAIL]

✅ 验证检查清单

修复完成后,请逐项检查以下配置:

1. 配置文件检查

文件: addons/shopro/config/ccblife.php

return [
    // 建行商户信息
    'merchant_id' => 'YOUR_MERCHANT_ID',
    'pos_id' => 'YOUR_POS_ID',
    'branch_id' => 'YOUR_BRANCH_ID',
    'service_id' => 'YOUR_SERVICE_ID',

    // ✅ 服务方公钥(用于MAC签名)
    'public_key' => '-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
-----END PUBLIC KEY-----',

    // ✅ 服务方私钥(用于解密)
    'private_key' => '-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...
-----END PRIVATE KEY-----',

    // ✅ 建行平台公钥(用于SIGN验签) - 新增必填!
    'platform_public_key' => '-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
-----END PUBLIC KEY-----',

    // 建行收银台URL
    'cashier_url' => 'https://ibsbjstar.ccb.com.cn/CCBIS/ccbMain',
];

2. 密钥格式验证

运行以下PHP脚本验证密钥格式:

<?php
$config = include 'addons/shopro/config/ccblife.php';

// 验证服务方公钥
$pubKey = openssl_pkey_get_public($config['public_key']);
if ($pubKey) {
    $details = openssl_pkey_get_details($pubKey);
    echo "✅ 服务方公钥: {$details['bits']}位\n";
} else {
    echo "❌ 服务方公钥格式错误\n";
}

// 验证服务方私钥
$privKey = openssl_pkey_get_private($config['private_key']);
if ($privKey) {
    $details = openssl_pkey_get_details($privKey);
    echo "✅ 服务方私钥: {$details['bits']}位\n";
} else {
    echo "❌ 服务方私钥格式错误\n";
}

// 验证建行平台公钥
$ccbPubKey = openssl_pkey_get_public($config['platform_public_key']);
if ($ccbPubKey) {
    $details = openssl_pkey_get_details($ccbPubKey);
    echo "✅ 建行平台公钥: {$details['bits']}位\n";
} else {
    echo "❌ 建行平台公钥格式错误或未配置\n";
}

3. 数据库字段检查

确保订单表包含建行相关字段:

ALTER TABLE `fa_shopro_order`
ADD COLUMN `ccb_pay_flow_id` VARCHAR(64) DEFAULT '' COMMENT '建行支付流水号',
ADD COLUMN `ccb_sync_status` TINYINT(1) DEFAULT 0 COMMENT '建行同步状态:0-未同步 1-已同步 2-失败',
ADD COLUMN `ccb_sync_time` INT(10) DEFAULT 0 COMMENT '建行同步时间';

4. 支付日志表检查

CREATE TABLE IF NOT EXISTS `fa_ccb_payment_log` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `order_id` INT(11) NOT NULL COMMENT '订单ID',
  `order_sn` VARCHAR(50) NOT NULL COMMENT '订单号',
  `pay_flow_id` VARCHAR(64) DEFAULT '' COMMENT '支付流水号',
  `payment_string` TEXT COMMENT '支付串',
  `user_id` INT(11) DEFAULT 0 COMMENT '用户ID',
  `ccb_user_id` VARCHAR(50) DEFAULT '' COMMENT '建行用户ID',
  `amount` DECIMAL(10,2) DEFAULT 0.00 COMMENT '支付金额',
  `status` TINYINT(1) DEFAULT 0 COMMENT '状态:0-待支付 1-已支付',
  `pay_time` INT(10) DEFAULT 0 COMMENT '支付时间',
  `trans_id` VARCHAR(64) DEFAULT '' COMMENT '建行交易流水号',
  `callback_data` TEXT COMMENT '回调数据',
  `create_time` INT(10) NOT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`),
  KEY `idx_order_id` (`order_id`),
  KEY `idx_pay_flow_id` (`pay_flow_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='建行支付日志表';

🧪 测试建议

测试环境准备

配置建行测试环境:
- 使用建行提供的测试商户号
- 配置测试环境的收银台URL
- 确保获取测试环境的平台公钥
测试用例:

TC1: 支付串生成测试

$service = new CcbPaymentService();
$result = $service->generatePaymentString($orderId);

// 验证点:
// 1. MAC长度为32位
// 2. ENCPUB字段存在且不为空
// 3. 支付串包含所有34个必需参数

TC2: 异步通知验签测试

// 模拟建行回调数据
$params = [
    'ORDERID' => 'test123',
    'PAYMENT' => '100.00',
    'SUCCESS' => 'Y',
    'SIGN' => '256字符十六进制字符串...'
];

$result = $service->handleNotify($params);
// 预期: 返回'success'或'fail'

TC3: 并发支付测试

使用Apache Bench进行并发测试:

ab -n 100 -c 10 http://your-domain/api/ccbpayment/callback

验证订单状态不会重复更新。

⚠️ 上线前必读

1. 建行生活支付验签公钥获取(重要!)

关键: 需要向建行生活技术支持索要**"建行生活支付验签公钥"**,用于异步通知SIGN验签。

为什么需要这个公钥?

建行用自己的私钥对异步通知进行RSA签名(生成SIGN字段)
你需要用建行的公钥来验证SIGN,确保通知是建行发送的
这个公钥不是你自己生成的公钥,是建行生活平台分配给你的

如何获取?

联系建行生活平台运营人员或技术支持
说明需要获取"建行生活支付验签公钥"(NT_TYPE=YS的验签公钥)
提供你的商户号和服务方编号
获取后配置到.env文件中

# .env文件
ccb_payment_verify_public_key="-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
-----END PUBLIC KEY-----"

未配置的影响

异步通知验签会降级为POSID验证
安全性降低,无法完全确认通知来源
但不会中断业务,系统仍可正常运行

2. 验证密钥格式

运行以下PHP脚本验证密钥配置是否正确:

<?php
// test_ccb_keys.php
$config = include 'addons/shopro/config/ccblife.php';

echo "========== 建行密钥配置验证 ==========\n\n";

// 1. 验证服务方公钥
$pubKey = openssl_pkey_get_public($config['public_key']);
if ($pubKey) {
    $details = openssl_pkey_get_details($pubKey);
    echo "✅ 服务方公钥: {$details['bits']}位 RSA\n";
} else {
    echo "❌ 服务方公钥格式错误: " . openssl_error_string() . "\n";
}

// 2. 验证服务方私钥
$privKey = openssl_pkey_get_private($config['private_key']);
if ($privKey) {
    $details = openssl_pkey_get_details($privKey);
    echo "✅ 服务方私钥: {$details['bits']}位 RSA\n";
} else {
    echo "❌ 服务方私钥格式错误: " . openssl_error_string() . "\n";
}

// 3. 验证建行支付验签公钥(可选)
if (!empty($config['ccb_payment_verify_public_key'])) {
    $ccbPubKey = openssl_pkey_get_public($config['ccb_payment_verify_public_key']);
    if ($ccbPubKey) {
        $details = openssl_pkey_get_details($ccbPubKey);
        echo "✅ 建行验签公钥: {$details['bits']}位 RSA\n";
    } else {
        echo "❌ 建行验签公钥格式错误: " . openssl_error_string() . "\n";
    }
} else {
    echo "⚠️  建行验签公钥未配置(验签会降级为POSID验证)\n";
}

echo "\n========== 验证完成 ==========\n";

3. 日志监控

修复后的代码已增强日志记录,请监控以下关键日志:

# 查看MAC签名日志
tail -f runtime/log/$(date +%Y%m)/*.log | grep '建行支付'

# 查看验签日志
tail -f runtime/log/$(date +%Y%m)/*.log | grep '建行验签'

# 查看异步通知日志
tail -f runtime/log/$(date +%Y%m)/*.log | grep '建行通知'

4. 回滚方案

如遇紧急问题,可回滚至修复前版本:

git checkout HEAD~1 addons/shopro/library/ccblife/
git checkout HEAD~1 addons/shopro/controller/Ccbpayment.php

📞 技术支持

开发者: Billy 修复日期: 2025-01-20 建行文档版本: v2.20 (2025-07-25)

如有疑问,请查阅:

建行接入文档: /doc/建行相关App服务方接入文档v2.20_20250725.html
本修复报告: /doc/建行支付对接修复报告.md

📝 变更历史

版本	日期	修改内容
v1.0	2025-01-20	初始版本,完成6项严重错误修复

15 KiB Raw Blame History

建行支付对接修复报告

⚠️ 重要修订说明

📋 修复概览

修复文件清单

🔴 致命错误修复

1. 支付串MAC签名算法错误

修复前 ❌

修复后 ✅

技术说明

2. ENCPUB字段生成逻辑错误

修复前 ❌

修复后 ✅

技术说明

3. 异步通知SIGN验签逻辑优化

修复前 ❌

修复后 ✅

技术说明

降级方案说明

🟡 严重问题修复

4. 订单状态更新缺少防重复逻辑

修复前 ❌

修复后 ✅

5. notify接口返回格式不规范

修复前 ❌

修复后 ✅

技术说明

⚡ 性能优化

6. RSA加密分段大小动态计算

优化前 ⚠️

优化后 ✅

🔐 建行接口签名规则总结

支付串生成流程

异步通知验签流程

✅ 验证检查清单

1. 配置文件检查

2. 密钥格式验证

3. 数据库字段检查

4. 支付日志表检查

🧪 测试建议

测试环境准备

TC1: 支付串生成测试

TC2: 异步通知验签测试

TC3: 并发支付测试

⚠️ 上线前必读

1. 建行生活支付验签公钥获取(重要!)

为什么需要这个公钥?

如何获取?

未配置的影响

2. 验证密钥格式

3. 日志监控

4. 回滚方案

📞 技术支持

📝 变更历史

15 KiB

Raw Blame History