ASP.NET Core（.NET 7）Web API中可为Guid参数设置默认值吗？

结论：无法直接在方法签名中为Guid值类型参数指定自定义的非空默认值，核心限制来自C#语言本身的编译规则。

原因说明 #

C#要求方法的可选参数默认值必须是编译时常量：

• Guid是值类型，字符串字面量（如"21c10283-6db0-489b-94d0-f0b3969fc799"）无法隐式转换为Guid类型；
• 通过Guid.Parse()或new Guid("...")生成的Guid实例属于运行时计算值，并非编译时常量，因此不能作为可选参数的默认值直接写在签名里。

可行的替代方案 #

方案1：保留当前的可空Guid+内部赋值逻辑（最简洁） #

你目前的写法是符合规范且有效的，若想让默认值更清晰，可通过XML注释补充文档说明：

/// <param name="tenantId">租户ID，未提供时默认使用：21c10283-6db0-489b-94d0-f0b3969fc799</param>
[HttpGet()]
public async Task<ActionResult<Foo>> PostSomething(Guid? tenantId) 
{
   tenantId ??= Guid.Parse("21c10283-6db0-489b-94d0-f0b3969fc799");
   // 业务逻辑
}

方案2：方法重载显式暴露默认值 #

通过重载无参数的方法，调用带Guid参数的重载并传入默认值，能让默认值在方法签名体系中体现：

[HttpGet]
public async Task<ActionResult<Foo>> PostSomething()
{
    // 直接传入默认Guid，显式暴露默认值
    return await PostSomething(Guid.Parse("21c10283-6db0-489b-94d0-f0b3969fc799"));
}

[HttpGet]
public async Task<ActionResult<Foo>> PostSomething(Guid tenantId)
{
    // 业务逻辑
}

方案3：利用绑定逻辑+文档注释（适配API文档工具） #

如果需要让Swagger等API文档工具显示默认值，可结合[FromQuery]和注释，同时保持内部赋值逻辑：

/// <param name="tenantId">租户ID，默认值：21c10283-6db0-489b-94d0-f0b3969fc799</param>
[HttpGet()]
public async Task<ActionResult<Foo>> PostSomething([FromQuery] Guid? tenantId) 
{
   tenantId ??= Guid.Parse("21c10283-6db0-489b-94d0-f0b3969fc799");
   // 业务逻辑
}

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