UniApp微信支付调起失败问题解决：商户参数错误的排查与修复

在UniApp里做微信支付时，不少人会遇到这种情况：后端接口正常、订单也生成了，但一点支付就报错，要么直接调不起微信，要么弹出"商户参数错误"。折腾半天也不知道哪里不对。这篇文章记录一下我遇到的坑和最终的处理方式。

1. 问题描述

在UniApp开发的安卓App中接入微信支付时，按官方文档配置了微信开放平台的应用信息，后端也返回了预支付订单数据，但调用支付时出现以下现象：

{
    "errMsg": "requestPayment:fail 商户参数错误",
    "errCode": -1,
    "code": -1
}

或者直接提示"调起微信支付失败"，没有任何详细错误信息。

2. 排查过程

2.1 检查 uni.requestPayment 参数

先确认 uni.requestPayment 的调用方式，微信支付需要传入 provider 和 orderInfo：

uni.requestPayment({
    provider: 'wxpay',
    orderInfo: orderInfo,  // 后端返回的微信支付订单对象
    success: function (res) {
        console.log('success:' + JSON.stringify(res));
    },
    fail: function (err) {
        console.log('fail:' + JSON.stringify(err));
    }
});

2.2 核对微信开放平台配置

排查了以下配置项：

• 应用包名是否与 manifest.json 中的包名一致
• 应用签名是否使用正确的 MD5 值（注意不是 SHA1）
• 是否已开通微信支付能力
• 商户号、AppID 是否与后端使用的一致

发现很多问题都出在应用签名上——微信要求的是 MD5 签名，且格式为 32 位小写、无冒号。

3. 解决方案揭秘

核心在于：应用签名必须与微信开放平台中配置的签名完全一致，且必须使用 MD5。

3.1 获取正确签名的步骤

1. 使用正式签名的 APK（或当前打包使用的 keystore）获取签名
2. 在项目根目录执行：

keytool -list -v -keystore your.keystore -alias your_alias

3. 取证书指纹中的 MD5 值，去掉冒号，转成 32 位小写字符串
4. 将该值填入微信开放平台「应用详情」中的「应用签名」一栏

3.2 完整实现示例

下面是一个带环境判断和错误处理的微信支付封装：

/**
 * 启动微信支付流程
 * @param orderInfo 微信支付订单对象（包含 appId、partnerId、prepayId、nonceStr、timeStamp、sign 等）
 * @param callbacks 回调函数集合
 */
static startWechatPayment(
  orderInfo: object,
  callbacks: {
    onSuccess?: (result: any) => void;
    onFail?: (error: any) => void;
  } = {}
): void {
  const { onSuccess, onFail } = callbacks;
  
  console.log('微信支付订单信息:', orderInfo);
  
  uni.requestPayment({
    provider: 'wxpay',
    orderInfo: orderInfo,
    success: function(result) {
      if (onSuccess) onSuccess(result);
    },
    fail: function(err) {
      console.error('微信支付失败:', err);
      if (onFail) onFail(err);
      
      // 用户取消不弹错误提示
      if (err.errCode !== -2 && err.errCode !== 'cancel') {
        uni.showToast({
          title: err.errMsg || '支付失败',
          icon: 'none'
        });
      }
    }
  });
}

4. 工作原理解析

4.1 为什么签名这么重要？

微信支付在调起时会校验应用身份，通过比对本地应用的签名和开放平台配置的签名是否一致。如果签名不一致，会直接拒绝调起，并返回「商户参数错误」之类的提示。

开发时如果用的是 debug 签名，而开放平台填的是正式签名，就会出现开发环境能调起、正式包不能调起的情况。

4.2 后端 orderInfo 格式要求

微信 App 支付需要的 orderInfo 通常包含：

• appId：微信开放平台应用 ID
• partnerId：商户号
• prepayId：预支付交易会话 ID
• nonceStr：随机字符串
• timeStamp：时间戳
• sign：签名

后端需按微信文档生成签名，前端直接透传该对象即可，不要自行拼接或修改。

5. 使用方法

5.1 简单调用示例

import PaymentUtil from '@/utils/payment';

// 从后端获取 orderInfo 后调用
PaymentUtil.startWechatPayment(
  orderInfoFromBackend,
  {
    onSuccess: (result) => {
      console.log('支付成功', result);
      uni.showToast({ title: '支付成功' });
    },
    onFail: (error) => {
      console.error('支付失败', error);
    }
  }
);

5.2 注意事项

• 仅适用于 App 端（安卓/iOS），H5 和小程序使用不同的支付方式
• 调试时建议在开放平台同时配置 debug 和 release 签名，或使用正式签名打包调试
• 确保手机已安装微信客户端，否则无法调起支付

6. 常见问题解答

Q: 签名确认无误，仍然报商户参数错误？

A: 检查包名是否与开放平台完全一致（含大小写），以及是否已提交审核并审核通过。新应用或新配置可能需要等待几分钟生效。

Q: 开发环境正常，正式包调不起？

A: 多为签名不一致。确认正式打包使用的 keystore 与开放平台中配置的签名一致。

Q: 如何获取 MD5 签名？

A: 使用 keytool -list -v -keystore xxx.keystore 查看证书指纹，取 MD5 那一行，去掉冒号并转为小写。

Q: iOS 也需要配置签名吗？

A: iOS 使用 Bundle ID 进行校验，需在开放平台填写正确的 Bundle ID，并确保与 Xcode 工程中的一致。

7. 总结

UniApp 集成微信支付时，除了常规的 AppID、商户号等配置，应用签名和包名必须与微信开放平台完全一致。很多「商户参数错误」都是签名或包名不匹配导致的，按上面步骤核对一遍，一般都能解决。

8. 参考资源

• UniApp 官方文档 - App 支付
• 微信支付开发文档 - App 支付
• 微信开放平台 - 应用签名说明