StartActiveSpan方法编辑器验证通过但编译报CS1501，重载存歧义

问题场景 #

调用代码：

var span = m_tracer.StartActiveSpan("FileTrace");

出现以下异常现象：

• 部分引用同一份源码的项目编译报错，输出窗口提示error CS1501: No overload for method 'StartActiveSpan' takes 1 arguments，但错误列表无任何提示；
• 其他项目中完全相同的代码可正常编译；
• 编辑器IntelliSense认可该语法（移除参数会标红，放回后红色波浪线消失），但编译环节失败。

查看方法签名发现两个重载：

public TelemetrySpan StartActiveSpan(
    string name,
    SpanKind kind,
    in TelemetrySpan? parentSpan,
    SpanAttributes? initialAttributes = null,
    IEnumerable<Link>? links = null,
    DateTimeOffset startTime = default)

public TelemetrySpan StartActiveSpan(
    string name,
    SpanKind kind = SpanKind.Internal,
    in SpanContext parentContext = default,
    SpanAttributes? initialAttributes = null,
    IEnumerable<Link>? links = null,
    DateTimeOffset startTime = default)

两个重载的首个参数均为string name，但第一个重载的第二个参数SpanKind kind为必填项，第二个重载的kind带默认值。单参数调用时，编译器无法确定匹配哪个重载，这是核心矛盾。

解决方案 #

1. 显式指定默认参数值 #

直接传入SpanKind的默认值，让编译器明确匹配带默认参数的重载，逻辑与原代码一致：

var span = m_tracer.StartActiveSpan("FileTrace", SpanKind.Internal);

2. 使用命名参数消除歧义 #

通过命名参数指定name，强制编译器定位到支持后续参数默认值的重载：

var span = m_tracer.StartActiveSpan(name: "FileTrace");

3. 统一依赖库版本 #

检查报错项目与正常项目引用的目标库（如OpenTelemetry相关包）版本是否一致，不同版本的方法签名可能存在差异，统一版本后可解决编译行为不一致的问题。

4. 清理编译缓存 #

清理Visual Studio编译缓存，解决潜在的缓存异常：

• 执行Build -> Clean Solution
• 删除项目目录下的bin和obj文件夹
• 重启Visual Studio后重新编译

内容的提问来源于stack exchange，提问作者Yossi G.