---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012082324.md"
title: "为什么请求返回401 Unauthorized？"
doc_id: 4012082324
---

>更新时间：2024.11.25

请根据报文中的message信息，在下表中找到错误的原因和对应的解决方案。

| 错误描述 | 原因 | 解决方案 |
| --- | --- | --- |
| 商户未设置APIv3密钥。 | 商户未设置APIv3密钥 | 请登录商户平台设置APIv3密钥 |
| 商户未申请过证书。 | 商户未申请过API证书 | 请参考[什么是商户API证书？如何获取商户API证书？](https://pay.weixin.qq.com/doc/v3/merchant/4013053053.md) |
| 商户证书序列号有误。 | 使用了错误的商户证书，或者使用了已经失效的历史的商户证书，或者获取的商户证书序列号有误 | 请检查商户证书序列号，登录商户平台【API安全】->【API证书】->【查看证书】，可查看商户API证书序列号。 |
| 商户证书已过期。 | 使用了已经过期的商户证书和私钥 | 请到商户平台重新申请证书后，使用新申请的证书 |
| 商户证书已作废。 | 使用了商户主动作废的商户证书和私钥 | 请到商户平台重新申请证书后，使用新申请的证书 |
| 错误的签名，导致验签失败。 | 使用了错误的商户私钥，或签名串构造不正确 | 请见下一问题 |
| HTTP头Authorization值格式错误 | 缺少 Authorization头，或其格式不正确 | 请检查上送的 Authorization，可以参考[authorization报错解决指南](https://pay.weixin.qq.com/doc/v3/merchant/4012365344.md) |
| HTTP头Authorization认证类型不正确 | 不支持 Authorization中声明的签名算法 | 请检查上送的 Authorization,目前仅支持WECHATPAY2-SHA256-RSA2048 |
| HTTP头Authorization中的timestamp与发起请求的时间不得超过5分钟 | Authorization头中的时间戳timestamp所示时间距离当前时间超过5分钟 | 请检查系统时间是否准确，或者获取时间的逻辑是否正确 |
| 已更换证书，请使用新证书 | 商户主动重新申请了商户API证书 | 请使用新申请的商户API证书 |