JeffreySu/WeiXinMPSDK · error · UnknownRequestMsgTypeException

MsgType： 在RequestMessageFactory中没有对应的处理程序！

Error message

MsgType：{0} 在RequestMessageFactory中没有对应的处理程序！

What it means

Thrown by DefaultWxOpenMessageContext.GetRequestEntityMappingResult when the incoming message's MsgType has no mapping in the request message factory, raising UnknownRequestMsgTypeException. WxOpen supports a known set of MsgTypes (text, image, event, etc.); anything else cannot be mapped to a request message entity.

Solutions

1. Upgrade Senparc.Weixin.WxOpen / Senparc.Weixin SDK packages to the latest version so newly added MsgTypes are mapped
2. Catch UnknownRequestMsgTypeException in the message handler pipeline and handle unknown types gracefully (log and return success so WeChat doesn't retry forever)
3. Verify only WxOpen message types are sent to the WxOpen message handler; route OfficialAccount messages to their own handler
4. Inspect the raw callback XML to confirm the MsgType value

Example fix

// before
try {
    var msg = messageContext.GetRequestEntityMappingResult(requestMsgType, doc);
} catch (UnknownRequestMsgTypeException ex) { /* unhandled */ }
// after
try {
    var msg = messageContext.GetRequestEntityMappingResult(requestMsgType, doc);
} catch (UnknownRequestMsgTypeException ex) {
    logger.LogWarning("Unknown MsgType: {0}", ex.Message);
    return new ResponseMessageNoResponse();
}

var knownTypes = new[] { "text", "image", "event" };
if (!knownTypes.Contains(requestMsgType, StringComparer.OrdinalIgnoreCase)) {
    logger.LogWarning("Unmapped MsgType {Type}; skipping", requestMsgType);
    return null;
}

bool IsSupportedMsgType(string t) =>
    t is "text" or "image" or "event"; // extend per SDK version

try {
    var msg = messageContext.GetRequestEntityMappingResult(requestMsgType, doc);
} catch (UnknownRequestMsgTypeException ex) {
    logger.LogWarning(ex, "Unknown MsgType from WeChat");
    return new WeixinResult("success"); // ack so WeChat stops retrying
}

When it happens

Trigger: Receiving a WeChat callback XML whose MsgType value is unknown/unsupported by this library version — e.g. new message types added by WeChat after this library release, corrupted XML with a missing/garbled MsgType, or messages forwarded from an OfficialAccount context.

Common situations: WeChat platform adds a new message type before the library is updated; testing with hand-crafted XML containing an invalid MsgType; using the WxOpen message handler to process OfficialAccount callbacks (link, location, etc.).

Understand the failure class

Background: Invalid enum value errors: "Unknown type", "Invalid scope", "must be one of" — when a string is not on the library's allowed list — this error's family across 23 libraries.

Related errors

• 微信公众号不支持 IRequestMessageFile 请求类型
• 微信公众号不支持 IRequestMessageLink 请求类型
• 微信公众号不支持 IRequestMessageLocation 请求类型
• 凭据提供器返回了空 AppSecret。
• SessionId无效（01）

AI-assisted analysis of JeffreySu/WeiXinMPSDK@be573f6f94 (2026-09-12). Data as JSON: /api/errors/3f6c79317e0a5231. Report an issue: GitHub.

Appendix: source

Thrown at src/Senparc.Weixin.WxOpen/src/Senparc.Weixin.WxOpen/Senparc.Weixin.WxOpen/MessageContexts/DefaultWxOpenMessageContext.cs:156

                        case "XPAY_COIN_PAY_NOTIFY": // 虚拟支付 代币支付推送
                            requestMessage = new RequestMessageEvent_XPayCoinPayNotify();
                            break;
                        case "XPAY_REFUND_NOTIFY": // 虚拟支付 退款推送
                            requestMessage = new RequestMessageEvent_XPayRefundNotify();
                            break;
                        case "XPAY_APPLE_SUBSCRIBE_SIGNING_RESULT_NOTIFY": // 虚拟支付 iOS 会员订阅签约结果推送
                            requestMessage = new RequestMessageEvent_XPayAppleSubscribeSigningResultNotify();
                            break;
                        case "XPAY_SUBSCRIBE_IOS_REFUND_QUERY_NOTIFY": // 虚拟支付 iOS 会员订阅退款推送
                            requestMessage = new RequestMessageEvent_XPaySubscribeIosRefundQueryNotify();
                            break;
                        default://其他意外类型（也可以选择抛出异常）
                            requestMessage = new RequestMessageEventBase();
                            break;
                    }
                    break;
                default:
                    throw new UnknownRequestMsgTypeException(string.Format("MsgType：{0} 在RequestMessageFactory中没有对应的处理程序！", requestMsgType), new ArgumentOutOfRangeException());//为了能够对类型变动最大程度容错（如微信目前还可以对公众账号suscribe等未知类型，但API没有开放），建议在使用的时候catch这个异常
            }
            return requestMessage;
        }

        /// <summary>
        /// 获取响应消息和实体之间的映射结果
        /// </summary>
        /// <param name="responseMsgType"></param>
        /// <returns></returns>
        public override IResponseMessageBase GetResponseEntityMappingResult(ResponseMsgType responseMsgType, XDocument doc = null)
        {
            IResponseMessageBase responseMessage;
            switch (responseMsgType)
            {
                case ResponseMsgType.Transfer_Customer_Service:
                    responseMessage = new ResponseMessageTransfer_Customer_Service();
                    break;
                case ResponseMsgType.NoResponse:

View on GitHub (pinned to be573f6f94)