uniapp 调用支付宝小程序支付时 uni.requestPayment 无法拉起

2026-10-24支付阿杰

结论

uni.requestPayment 无法拉起支付宝小程序支付，问题通常不在拉起动作本身，而在以下环节：

代码没有运行在支付宝小程序环境中；
后端尚未创建支付宝交易，或返回的 tradeNO 无效；
orderInfo 使用了 App 支付参数，而非支付宝小程序参数；
小程序、支付宝应用、商户账号或支付产品没有正确关联；
请求报错后未记录失败信息，看起来像是“没有反应”。

排查时，先确认运行平台，再查看后端下单结果和 fail 回调。支付宝小程序支付通常需要后端先创建交易，再将支付宝交易号返回前端。普通业务订单号不能直接传给 uni.requestPayment。

正确的调用流程

完整流程如下：

小程序向业务后端发起下单请求；
后端调用支付宝相关接口创建交易；
支付宝返回交易号，例如 trade_no；
后端将交易号返回小程序；
小程序通过 uni.requestPayment 拉起收银台；
支付结束后，以后端收到的支付宝异步通知或主动查询结果确认最终支付状态。

前端回调只能反映用户侧的调用结果，不能作为发货、充值或记账的唯一依据。

前端调用示例

支付宝小程序与 App 支付使用的参数不同。如果后端返回的是支付宝交易号，可以按照当前 uni-app 版本的支付宝小程序文档组织 orderInfo：

async function pay(orderId) {
  try {
    const [requestError, response] = await uni.request({
      url: 'https://example.com/api/payment/alipay/create',
      method: 'POST',
      data: {
        orderId
      }
    })

    if (requestError) {
      throw requestError
    }

    const tradeNO =
      response.data.tradeNO ||
      response.data.trade_no

    if (!tradeNO) {
      throw new Error('后端未返回支付宝交易号 tradeNO')
    }

    console.log('支付宝交易号：', tradeNO)

    uni.requestPayment({
      provider: 'alipay',
      orderInfo: {
        tradeNO
      },
      success(res) {
        console.log('支付调用成功：', res)
        verifyPaymentResult(orderId)
      },
      fail(err) {
        console.error('支付调用失败：', JSON.stringify(err))
        uni.showModal({
          title: '支付未完成',
          content: err.errMsg || '无法拉起支付宝收银台',
          showCancel: false
        })
      }
    })
  } catch (err) {
    console.error('创建支付订单失败：', err)
  }
}

不同的 uni-app、HBuilderX 版本及发布端，对 orderInfo 的参数形式可能有不同要求。如果当前版本文档要求直接传入交易号，应改为：

uni.requestPayment({
  provider: 'alipay',
  orderInfo: tradeNO,
  success(res) {
    console.log('支付调用成功：', res)
  },
  fail(err) {
    console.error('支付调用失败：', err)
  }
})

不要直接套用 App 端支付宝支付的签名订单字符串。具体参数应以项目使用的 uni-app 版本和支付宝小程序端文档为准。

重点排查项

1. 确认运行环境

设置 provider: 'alipay'，并不意味着代码可以在任意平台上按支付宝小程序的方式发起支付。首先要确认项目确实编译并运行在支付宝小程序中。

可以使用条件编译，避免其他平台误调用：

// #ifdef MP-ALIPAY
uni.requestPayment({
  provider: 'alipay',
  orderInfo: {
    tradeNO
  },
  success(res) {
    console.log(res)
  },
  fail(err) {
    console.error(err)
  }
})
// #endif

还可以查询当前环境支持的支付服务：

uni.getProvider({
  service: 'payment',
  success(res) {
    console.log('当前支付服务：', res.provider)
  },
  fail(err) {
    console.error('获取支付服务失败：', err)
  }
})

如果返回结果中没有 alipay，应先检查运行平台、编译目标和基础库环境。

2. 检查 `tradeNO` 是否正确

这里需要传入支付宝创建交易后返回的交易号，不能使用以下内容：

业务系统自己的订单号；
商户订单号 out_trade_no；
二维码内容；
App 支付使用的完整签名字符串；
已关闭、已支付或已失效交易的编号。

调试时，可同时打印后端原始返回值和前端最终传入的参数，确认交易号不为空、字段名没有写错，也没有在 JSON 转换过程中丢失。

3. 检查后端下单是否成功

如果后端创建交易时已经失败，前端就无法拉起收银台。后端需要记录支付宝返回的错误码、错误信息和请求标识，并检查以下内容：

应用 ID 是否正确；
商户身份与应用是否匹配；
私钥、公钥和签名方式是否配置正确；
支付产品是否已经开通；
小程序与收款应用、商户账号是否完成必要关联；
金额、订单标题等必填参数是否合法；
测试环境与正式环境是否混用。

不要在前端生成签名，也不要在前端保存商户私钥。创建交易和验签都应由服务端完成。

4. 查看真实失败信息

“没有拉起”只是表面现象，具体错误通常会进入 fail 回调。调试时应完整记录错误对象，不能只显示一条简单提示：

fail(err) {
  console.error('requestPayment fail:', err)
  console.error('requestPayment fail JSON:', JSON.stringify(err))
}

还需要检查：

支付宝小程序开发者工具控制台；
真机调试日志；
下单接口的网络响应；
服务端调用支付宝接口的日志。

如果开发者工具和真机的表现不同，应重点参考真机测试结果。部分支付能力可能无法在模拟环境中完整验证。

5. 检查调用时机

支付应由用户的明确操作触发，例如点击“立即支付”按钮。不要在页面初始化、定时器、后台回调或重复提交逻辑中自动拉起支付。

同时要防止用户连续点击：

let paying = false

async function handlePay() {
  if (paying) return

  paying = true

  try {
    await createAndPay()
  } finally {
    paying = false
  }
}

6. 必要时使用支付宝原生 API 定位问题

如果无法确定 uni.requestPayment 的参数是否适配正确，可以只在支付宝小程序端临时使用原生 API 进行对照测试：

// #ifdef MP-ALIPAY
my.tradePay({
  tradeNO,
  success(res) {
    console.log('my.tradePay success:', res)
  },
  fail(err) {
    console.error('my.tradePay fail:', err)
  }
})
// #endif

如果 my.tradePay 能正常拉起收银台，而 uni.requestPayment 不能，问题更可能出在当前 uni-app 版本的参数格式或平台适配层。如果两者都失败，则需要继续检查交易号、应用配置和商户权限。

支付结果处理

前端收到支付成功回调后，建议再请求后端查询订单状态：

function verifyPaymentResult(orderId) {
  uni.request({
    url: `https://example.com/api/orders/${orderId}/payment-status`,
    method: 'GET',
    success(res) {
      if (res.data.paid === true) {
        uni.showToast({
          title: '支付成功',
          icon: 'success'
        })
      } else {
        uni.showToast({
          title: '支付结果确认中',
          icon: 'none'
        })
      }
    }
  })
}

即使前端回调显示成功，也要由后端对支付宝异步通知进行验签，或主动查询交易状态，确认后再更新业务订单。

注意事项

不要混用支付宝 App 支付、小程序支付和网页支付的订单参数。
不要将商户订单号当成支付宝交易号。
不要在前端保存应用私钥或生成服务端签名。
除了处理 success，还要记录 fail 返回的完整错误信息。
不要仅凭前端回调将订单状态改为已支付。
升级 HBuilderX 或 uni-app 后，要重新核对对应版本的 requestPayment 参数格式。
排查时使用金额较小、状态全新的订单，避免重复使用同一个交易号。