JeffreySu/WeiXinMPSDK · error · WeixinOpenException

注册AuthorizerContainer之前，必须先注册对应的ComponentContainer！Component…

Error message

注册AuthorizerContainer之前，必须先注册对应的ComponentContainer！ComponentAppId：{0},AuthorizerAppId:{1}

What it means

AuthorizerContainer.RegisterAsync requires the parent open-platform ComponentContainer to already be registered for the given componentAppId. When ComponentContainer.TryGetItemAsync returns null, it throws WeixinOpenException telling you to register the ComponentContainer first.

Solutions

1. Call ComponentContainer.Register(componentAppId, componentSecret, ...) before AuthorizerContainer.Register.
2. Verify the componentAppId matches exactly (no whitespace/typo) the one used in ComponentContainer.Register.
3. Move component registration to the earliest point of application startup.
4. Guard with ComponentContainer.CheckRegistered(componentAppId) before authorizer registration.

Example fix

// before
await AuthorizerContainer.RegisterAsync(componentAppId, authorizerAppId, name);
// after
ComponentContainer.Register(componentAppId, componentSecret, componentName);
await AuthorizerContainer.RegisterAsync(componentAppId, authorizerAppId, name);

if (!ComponentContainer.CheckRegistered(componentAppId))
    throw new InvalidOperationException($"Register ComponentContainer for {componentAppId} first");

try { await AuthorizerContainer.RegisterAsync(componentAppId, authorizerAppId, name); }
catch (WeixinOpenException ex) { logger.Error(ex, "Component not registered"); throw; }

When it happens

Trigger: Calling AuthorizerContainer.Register (or TryRegisterAsync) with a componentAppId that was never registered via ComponentContainer.Register, or a componentAppId with a typo.

Common situations: Startup code registers authorizers before the component; different componentAppId strings between environments (dev/prod); app settings typo; DI container ordering runs authorizer registration before component registration.

Understand the failure class

Background: "X is required", "must be set", "cannot be empty": the missing-required-config error family, from Vertex AI project/location to WeChat keys — this error's family across 18 libraries.

Related errors

• 此appId尚未注册，ComponentContainer.Register完成注册（全局执行一次即可）！
• GetComponentVerifyTicketFunc必须在注册时提供！
• 注册委托容量必须大于 0。
• 当前已有 个注册委托，不能把容量降低到 。
• 注册委托数量已达到上限 ，请先注销不再使用的账号或提高…

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

Appendix: source

Thrown at src/Senparc.Weixin.Open/Senparc.Weixin.Open/Containers/AuthorizerContainer.cs:494

        #endregion

        #endregion


        #region 异步方法

        /// <summary>
        /// 【异步方法】注册应用凭证信息，此操作只是注册，不会马上获取Ticket，并将清空之前的Ticket，
        /// </summary>
        /// <param name="authorizerAppId"></param>
        /// <param name="componentAppId"></param>
        /// <param name="name">标记Authorizer名称（如微信公众号名称），帮助管理员识别</param>
        private static async Task RegisterAsync(string componentAppId, string authorizerAppId, string name = null)
        {
            var componentBag = await ComponentContainer.TryGetItemAsync(componentAppId);
            if (componentBag == null)
            {
                throw new WeixinOpenException(string.Format("注册AuthorizerContainer之前，必须先注册对应的ComponentContainer！ComponentAppId：{0},AuthorizerAppId:{1}", componentAppId, authorizerAppId));
            }

            SetRegistrationCallback(authorizerAppId, async () =>
             {
                 //using (FlushCache.CreateInstance())
                 //{
                 var bag = new AuthorizerBag()
                 {
                     Name = name,

                     AuthorizerAppId = authorizerAppId,
                     ComponentAppId = componentAppId,

                     AuthorizationInfo = new AuthorizationInfo(),
                     AuthorizationInfoExpireTime = DateTimeOffset.MinValue,

                     AuthorizerInfo = new AuthorizerInfo(),
                     //AuthorizerInfoExpireTime = DateTimeOffset.MinValue,

View on GitHub (pinned to be573f6f94)