解决“当前扩展缓存策略没有进行注册”的错误

　　造成这个错误的原因是在使用 Senparc.Weixin SDK 或者 CO2NET 的扩展缓存的时候，没有对扩展缓存策略进行注册（激活）。解决方案如下：

 

　　第一步：先升级到 Senparc.Weixin 的最新版本 v5.0.11 以上（依赖 CO2NET v0.1.11 以上）：https://www.nuget.org/packages/Senparc.Weixin

　　第二步：检查是否加入了一行代码：

 

.NET Framework：

　　在 global.asax.cs 文件的 Application_Start() 方法中，加入代码（注意 using 两个命名空间：Senparc.CO2NET 和 Senparc.Weixin）：

//...

var isGLobalDebug = true;设置全局 Debug 状态
var senparcSetting = SenparcSetting.BuildFromWebConfig(isGLobalDebug);
var register = RegisterService.Start(senparcSetting).UseSenparcGlobal();CO2NET全局注册，必须！

var isWeixinDebug = 设置微信 Debug 状态
var senparcWeixinSetting = SenparcWeixinSetting.BuildFromWebConfig(isWeixinDebug);
register.UseSenparcWeixin(senparcWeixinSetting,senparcSetting);//微信全局注册，必须！

...

 

.NET Core：

　　在 startup.cs 中的 ConfigureServices() 和 Configure() 中分别加入代码（注意 using 两个命名空间：Senparc.CO2NET 和 Senparc.Weixin）：

public void ConfigureServices(IServiceCollection services)
{
    ...
    services.AddSenparcGlobalServices(Configuration)Senparc.CO2NET 全局注册
            .AddSenparcWeixinServices(Configuration);Senparc.Weixin 注册（如果使用Senparc.Weixin SDK则添加）
    ...
}

 

public void Configure(IApplicationBuilder app,IHostingEnvironment env,IOptions<SenparcSetting> senparcSetting,IOptions<SenparcWeixinSetting> senparcWeixinSetting)
{
    ...
    
    IRegisterService register = RegisterService.Start(env,senparcSetting.Value).UseSenparcGlobal(); 启动 CO2NET 全局注册，必须！
    
    register.UseSenparcWeixin(senparcWeixinSetting.Value,senparcSetting.Value);微信全局注册，必须！
    
}

　只需要上述几行代码即可。 

 

 

　　进阶

　　如果你的系统里面自己扩展了 CO2NET 的缓存策略（非 Senparc 官方的 LocalContainerCacheStrategy、RedisContainerCacheStrategy、MemcachedContainerCacheStrategy等），那么上述的 .UseSenparcGlobal([第一个参数],[第二个参数]) 的第二个参数需要提供一个扩展的列表，以 .net core为例：

RegisterService.Start(env /* .net framework 没有这个参数 */,senparcSetting).UseSenparcGlobal(false,GetExCacheStrategies);必须

　　其中，GetExCacheStrategies 方法如下（以 .net core Demo 为例，.net framework 下面的 Demo 没有 senparcWeixinSetting 参数）：

        /// <summary>
        /// 获取扩展缓存策略
        </summary>
        <returns></returns>
        private IList<IDomainExtensionCacheStrategy> GetExCacheStrategies(SenparcWeixinSetting senparcWeixinSetting)
        {
            var exContainerCacheStrategies = new List<IDomainExtensionCacheStrategy>();

            注意：以下两个 if 判断仅作为演示，方便大家添加自定义的扩展缓存策略，
                 只要进行了 register.UseSenparcWeixin() 操作，Container 的缓存策略下的 Local、Redis 和 Memcached 系统已经默认自动注册，无需操作！

            #region 演示扩展缓存注册方法

            判断Redis是否可用
            var redisConfiguration = senparcWeixinSetting.Cache_Redis_Configuration;
            if ((!string.IsNullOrEmpty(redisConfiguration) && redisConfiguration != "Redis配置"))
            {
                exContainerCacheStrategies.Add(RedisContainerCacheStrategy.Instance);
            }

            判断Memcached是否可用
            var memcachedConfiguration = senparcWeixinSetting.Cache_Memcached_Configuration;
            string.IsNullOrEmpty(memcachedConfiguration) && memcachedConfiguration != Memcached配置))
            {
                exContainerCacheStrategies.Add(MemcachedContainerCacheStrategy.Instance);TODO:如果没有进行配置会产生异常
            }

            #endregion

            扩展自定义的缓存策略

            return exContainerCacheStrategies;
        }

 　　注意：上述代码以 Senparc.Weixin SDK 的扩展缓存实现为例（用于 Container 的 Redis 和 Memecahed）实际上这两个扩展缓存再加上 LocalContainerCacheStrategy 已经在执行 register.UseSenparcWeixin() 的时候自动注册，无需多此一举。

 

　　当然，这样有时候还是会稍显麻烦，所以我们又提供了一个自动扫描所有的扩展缓存并注册的方法，完全由系统自动完成：

RegisterService.Start(senparcSetting).UseSenparcGlobal(true,null);//必须

　　注意：当地一个参数为 true 时，虽然省去了指定缓存的代码，但是全局的扫描需要消耗一定的时间，会导致系统启动时间增加。粗略地测试，每个程序集（可近似理解为dll）会延长8毫秒左右的启动时间。

 

PS：

 　　Senparc.Weixin 默认提供了三种 Container 的扩展缓存策略：

• LocalContainerCacheStrategy
• RedisContainerCacheStrategy
• MemcachedContainerCacheStrategy

　　您也可以编写自己的扩展缓存策略。