JeffreySu/WeiXinMPSDK · error · MessageHandlerException

微信公众号不支持 IResponseMessageImage 响应类型

Error message

微信公众号不支持 IResponseMessageImage 响应类型

What it means

WxOpenMessageEntityEnlightener.NewResponseMessageImage unconditionally throws MessageHandlerException. Image response messages are a 公众号 (MP) reply type not supported by WxOpen, so the response-entity factory refuses to build one.

Solutions

1. Return a supported WxOpen response type instead, e.g. ResponseMessageText (see NewResponseMessageText).
2. Remove or branch the image-reply code path in the WxOpen handler.
3. Use customer-service messages (e.g. ResponseMessageTransfer_Customer_Service) to hand off to MP-side media replies.

Example fix

// before
public override IResponseMessageImage OnXxxRequest(...) =>
    requestMessageHandler.NewResponseMessageImage();
// after
public override IResponseMessageBase OnXxxRequest(...) =>
    requestMessageHandler.NewResponseMessageText(); // image replies unsupported in WxOpen

static readonly HashSet<Type> WxOpenResponseTypes = new()
    { typeof(IResponseMessageText), typeof(IResponseMessageTransfer_Customer_Service) };
if (!WxOpenResponseTypes.Contains(responseType)) return null; // avoid unsupported response types

static bool IsSupportedWxOpenResponse<T>() where T : IResponseMessageBase =>
    typeof(T) != typeof(IResponseMessageImage);

try
{
    var resp = enlightener.NewResponseMessageImage();
}
catch (MessageHandlerException)
{
    resp = enlightener.NewResponseMessageText(); // fallback reply
}

When it happens

Trigger: Calling NewResponseMessageImage() on the WxOpen enlightener, typically when a WxOpen On* handler tries to return an image response or when code shares MP response-building logic with WxOpen.

Common situations: Copy-pasting MP OnTextRequest-style reply code into a WxOpen handler; building generic reply factories that produce image responses for all channels.

Understand the failure class

Background: UnsupportedOperationException and "is not supported" errors: when a library deliberately refuses a call — this error's family across 30 libraries.

Related errors

• 微信公众号不支持 IResponseMessageMpNews 响应类型
• 微信公众号不支持 IResponseMessageMusic 响应类型
• 微信公众号不支持 IResponseMessageNews 响应类型
• 微信公众号不支持 IResponseMessageVideo 响应类型
• 微信公众号不支持 IResponseMessageVoice 响应类型

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

Appendix: source

Thrown at src/Senparc.Weixin.WxOpen/src/Senparc.Weixin.WxOpen/Senparc.Weixin.WxOpen/MessageHandlers/WxOpenMessageEntityEnlightener.cs:64

        public override IRequestMessageText NewRequestMessageText()
        {
            return new RequestMessageText();
        }

        public override IRequestMessageVideo NewRequestMessageVideo()
        {
            throw new MessageHandlerException("微信公众号不支持 IRequestMessageVideo 请求类型");
        }

        public override IRequestMessageVoice NewRequestMessageVoice()
        {
            throw new MessageHandlerException("微信公众号不支持 IRequestMessageVoice 请求类型");
        }

        public override IResponseMessageImage NewResponseMessageImage()
        {
            throw new MessageHandlerException("微信公众号不支持 IResponseMessageImage 响应类型");
        }

        public override IResponseMessageMpNews NewResponseMessageMpNews()
        {
            throw new MessageHandlerException("微信公众号不支持 IResponseMessageMpNews 响应类型");
        }

        public override IResponseMessageMusic NewResponseMessageMusic()
        {
            throw new MessageHandlerException("微信公众号不支持 IResponseMessageMusic 响应类型");
        }

        public override IResponseMessageNews NewResponseMessageNews()
        {
            throw new MessageHandlerException("微信公众号不支持 IResponseMessageNews 响应类型");
        }

        public override IResponseMessageText NewResponseMessageText()

View on GitHub (pinned to be573f6f94)