.NET Core3.1迁移至.NET6遇CS0121调用歧义错误求解决

问题原因 #

.NET 6的Microsoft.Extensions.Configuration.ConfigurationExtensions类已内置GetRequiredSection扩展方法，其签名与你自定义的Common.Extensions.ConfigurationExtensions.GetRequiredSection完全一致，编译器无法判定调用目标，因此抛出CS0121歧义错误。

另外需要注意：你自定义方法中section is null的判断是无效逻辑——IConfiguration.GetSection永远不会返回null，即使目标配置节不存在，也会返回一个IConfigurationSection实例，只是其Exists()方法会返回false。

解决方案 #

方案1：删除自定义的GetRequiredSection方法 #

直接移除Common.Extensions.ConfigurationExtensions中的GetRequiredSection方法，使用.NET 6官方内置的同名方法即可。官方方法逻辑更严谨：它会通过section.Exists()检查配置节是否存在，不存在时抛出InvalidOperationException，完全覆盖你自定义方法的需求。

方案2：显式指定调用的方法命名空间 #

若需保留自定义方法，在调用时通过完整命名空间限定明确指定目标方法：

// 调用官方内置方法
var personalizedUrls = Microsoft.Extensions.Configuration.ConfigurationExtensions.GetRequiredSection(configuration, @"PersonalizedUrls");

// 或者调用自定义方法
var personalizedUrls = Common.Extensions.ConfigurationExtensions.GetRequiredSection(configuration, @"PersonalizedUrls");

方案3：修改自定义方法的签名 #

修改自定义方法的名称或添加额外参数，让其签名与官方方法区分开。例如：

namespace Common.Extensions
{
    public static class ConfigurationExtensions
    {
        // 修改方法名
        public static IConfigurationSection GetRequiredConfigSection(this IConfiguration configuration, string sectionName)
        {
            var section = configuration.GetSection(sectionName);
            if (!section.Exists())
            {
                throw new InvalidOperationException($"The configuration is missing the {sectionName} section");
            }

            return section;
        }

        // 或者添加可选参数
        public static IConfigurationSection GetRequiredSection(this IConfiguration configuration, string sectionName, bool throwOnMissing = true)
        {
            var section = configuration.GetSection(sectionName);
            if (throwOnMissing && !section.Exists())
            {
                throw new InvalidOperationException($"The configuration is missing the {sectionName} section");
            }

            return section;
        }
    }
}

内容的提问来源于stack exchange，提问作者lapots