ASP.NET Core 6 Web API POST路由可选参数默认值设置问题

核心问题分析 #

1. 路由参数"可选"的定义：路由中标记{id3?}是指该路径段可省略，而非允许传递null字符串。调用/111/222/null时，id3会被解析为字符串"null"，而非null，因此不会触发参数默认值。
2. 末尾斜杠的路由匹配规则：ASP.NET Core默认不匹配末尾带斜杠的路由（如/111/222/），直接返回404。
3. 参数默认值生效条件：仅当参数未从路由、查询字符串等任何来源绑定到值时，才会使用默认值。如果路由要求必须提供参数段，即使传递空字符串，默认值也不会生效。

正确配置方案 #

1. 路由与参数的正确写法 #

在控制器方法上配置可选路由参数，同时指定参数默认值：

[ApiController]
[Route("api/import/v1")]
public class ImportController : ControllerBase
{
    // 正确配置：路由参数id3标记为可选，参数设置默认值
    [HttpPost("{id1}/{id2}/{id3?}")]
    public IActionResult Test(string id1, string id2, string id3 = "000")
    {
        return Ok(new { id1, id2, id3 });
    }

    [HttpPost("Test2")]
    public IActionResult Test2(string id1, string id2, string id3 = "000")
    {
        return Ok(new { id1, id2, id3 });
    }
}

2. 允许末尾斜杠匹配（解决404） #

在Program.cs中配置路由选项，允许请求URL末尾带斜杠：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器服务并配置路由选项
builder.Services.AddControllers(options =>
{
    // 允许匹配末尾带斜杠的请求
    options.AllowTrailingSlash = true;
    // 可选：自动给响应URL添加末尾斜杠
    options.AppendTrailingSlash = true;
});

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

有效调用方式 #

• 提供所有参数：https://localhost:7071/api/import/v1/111/222/333 → id3="333"
• 省略id3参数：https://localhost:7071/api/import/v1/111/222 → id3="000"（触发默认值）
• 传递空字符串作为id3：https://localhost:7071/api/import/v1/111/222/ → id3=""（此时不会触发默认值，因为路由段已提供空字符串）

常见误区修正 #

• 不要通过传递null字符串触发默认值：/111/222/null会让id3等于"null"，而非null。
• 若路由未标记参数为可选（{id3}而非{id3?}），则必须提供该参数段，否则返回404，且参数默认值不会生效。

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