uniapp支付宝支付闪退：签名错误导致应用崩溃

Question

在使用 UniApp 集成支付宝支付时，常因签名配置错误导致应用闪退。典型问题出现在 Android 端打包时，未正确配置 RSA2 签名公钥或私钥，或在支付宝开放平台填写的签名与实际打包 APK 使用的签名不一致。此外，HBuilderX 打包时选择的证书与上传至支付宝后台的 SHA-1/SHA-256 指纹不符，也会引发“签名验证失败”而导致支付调用瞬间崩溃。该问题日志通常提示“sign error”或“ALI40247”，需仔细核对本地签名、打包方式及开放平台配置是否匹配。

Answer 1

一、问题背景与现象分析

在使用 UniApp 集成支付宝支付功能时，Android 端频繁出现应用闪退现象，其根本原因大多集中于签名配置错误。开发者在调用 uni.requestPayment 接口后，应用立即崩溃或弹出“支付失败”提示，日志中常出现 “sign error” 或 “ALI40247” 错误码。

该问题本质是支付宝 SDK 在校验应用身份时，发现本地 APK 的签名指纹（SHA-1/SHA-256）与支付宝开放平台注册信息不一致，导致安全验证失败，进而中断支付流程。

二、常见技术问题清单

• 未正确生成 RSA2 公私钥对，使用了 RSA 而非 RSA2 算法
• 支付宝开放平台填写的公钥与客户端实际使用的私钥不匹配
• HBuilderX 打包时选择的证书指纹（SHA-1/SHA-256）未同步至支付宝后台
• 调试包与正式包使用不同 keystore，但未分别配置对应签名
• 多环境打包（如测试、生产）未区分签名配置
• 混淆或压缩过程中私钥被误删或路径错误
• 未在 manifest.json 中正确配置 alipay 模块权限
• Android 原生层未集成最新版 mspay SDK
• UniApp 项目中引用了过期的插件版本
• HTTPS 回调地址未通过支付宝白名单校验

三、签名机制深度解析

支付宝支付依赖于非对称加密体系，采用 RSA2（即 SHA256WithRSA）算法进行签名验证。开发者需在本地生成密钥对：

# 生成私钥
openssl genrsa -out app_private_key.pem 2048

# 导出公钥
openssl rsa -in app_private_key.pem -pubout -out app_public_key.pem

将生成的公钥内容（去除头尾标识符）上传至支付宝开放平台的应用设置页。而私钥则用于在服务端对订单参数进行签名，生成 sign 字段。

同时，Android 应用本身还需通过 keystore 进行应用级签名，支付宝会校验该应用的证书指纹（SHA-1 和 SHA-256）是否与平台登记的一致。

四、配置一致性校验流程图

graph TD A[开始] --> B{是否为正式包?} B -- 是 --> C[获取正式 keystore] B -- 否 --> D[使用 HBuilderX 默认调试 keystore] C --> E[提取 SHA-1/SHA-256 指纹] D --> E E --> F[登录支付宝开放平台] F --> G[核对已注册的签名指纹] G --> H{是否一致?} H -- 否 --> I[更新平台签名信息] H -- 是 --> J[继续构建] I --> J J --> K[完成打包并集成]

五、解决方案与操作步骤

步骤	操作内容	工具/位置
1	确认使用 RSA2 算法生成密钥	OpenSSL 命令行
2	导出 keystore 的 SHA-1 和 SHA-256	keytool -list -v -keystore xxx.keystore
3	将公钥（非私钥）上传至支付宝开放平台	https://open.alipay.com
4	在 HBuilderX 中选择正确的 keystore 文件	发行 → 原生 App → 云打包
5	检查 manifest.json 是否启用 Alipay 支付模块	"appid": "xxx", "permissions": ["AlipayPay"]
6	服务端使用私钥对订单字符串签名	Alipay SDK 提供的 sign 方法
7	确保回调地址为 HTTPS 且在白名单内	支付宝网关配置页面
8	真机测试前清除旧版本应用	adb uninstall 包名
9	查看 logcat 日志过滤关键词 “alipay”	Android Studio / adb logcat
10	验证支付接口返回 error_code 是否消失	uni.requestPayment fail 回调