可选参数引发构造函数冲突，如何保留常用构造并解决调用歧义？

你的问题核心是构造函数重载因可选参数和参数类型匹配优先级导致的歧义调用，以下是几种可行的解决方式：

方案一：使用静态工厂方法（推荐） #

将构造函数私有化，通过命名清晰的静态方法对外提供实例，彻底消除重载歧义，同时提升代码可读性：

public class NotFoundError : BaseError // 假设继承自你的BaseError类
{
    public int Code { get; }

    // 私有构造函数，仅内部调用
    private NotFoundError(string message, int code = 0) : base(message)
    {
        Code = code;
    }

    // 专门用于实体找不到的场景（对应原第一个构造）
    public static NotFoundError ForEntity(string name, object key, int code = 0)
    {
        return new NotFoundError($"Entity '{name}' ({key}) was not found.", code);
    }

    // 用于自定义错误消息的场景（对应原第二个构造）
    public static NotFoundError WithCustomMessage(string message, int code = 0)
    {
        return new NotFoundError(message, code);
    }
}

调用方式：

• 实体找不到场景（99%常用）：

  throw NotFoundError.ForEntity(nameof(Customer), request.Id);
  // 带自定义错误码：
  throw NotFoundError.ForEntity(nameof(Customer), request.Id, 404);
  

• 自定义消息场景：

  throw NotFoundError.WithCustomMessage("自定义错误描述", 500);
  

方案二：调整构造函数参数顺序 #

修改第二个构造函数的参数顺序，将可选的code放在首位，强制调用时必须明确参数位置或名称，避免歧义：

public NotFoundError(string name, object key, int code = 0)
    : base($"Entity '{name}' ({key}) was not found.")
{
    Code = code;
}

public NotFoundError(int code = 0, string message)
    : base(message)
{
    Code = code;
}

调用方式：

• 实体找不到场景（无歧义）：

  throw new NotFoundError(nameof(Customer), request.Id);
  

• 自定义消息场景：

  // 不带错误码，需指定参数名
  throw new NotFoundError(message: "自定义错误描述");
  // 带错误码
  throw new NotFoundError(500, "自定义错误描述");
  

方案三：调用时显式指定参数名 #

在调用第一个构造函数时，明确指定参数名称，引导编译器匹配目标重载：

throw new NotFoundError(name: nameof(Customer), key: request.Id);
// 带自定义错误码：
throw new NotFoundError(name: nameof(Customer), key: request.Id, code: 404);

这种方式无需修改构造函数，但每次调用都需额外编写参数名，适合临时兼容场景。

原问题原因补充 #

当你调用new NotFoundError(nameof(Customer), request.Id)时，若request.Id是值类型（如int），编译器会优先匹配第二个构造函数——因为第二个构造的第二个参数是int（与request.Id类型完全匹配），而第一个构造的第二个参数是object（需要装箱转换），C#编译器会选择类型匹配更精确的重载。

内容的提问来源于stack exchange，提问作者Tom el Safadi