ASP.NET Core Minimal API 中 FromForm 绑定的常见问题解析

在 ASP.NET Core 的 Minimal API 开发中，使用 [FromForm] 进行模型绑定时会遇到一些典型问题。本文将深入分析这些问题及其解决方案，帮助开发者更好地理解表单绑定的工作机制。

空字符串与值类型属性的绑定问题

当表单中包含空字符串值时，尝试绑定到值类型属性（如 DateOnly 或 DateTime）时会抛出异常。这是 ASP.NET Core 表单绑定层的一个已知行为。

例如，当尝试将空字符串绑定到 DateOnly? Birthday 属性时，系统会抛出 BadHttpRequestException 异常，提示"值''对'Birthday'无效"。

这个问题在 .NET 10 中已得到修复，新的表单绑定层会将空字符串视为 null 值来处理。对于 .NET 9 及以下版本，开发者可以通过以下方式解决：

1. 在模型类中实现自定义的 BindAsync 方法，手动处理空字符串情况
2. 在前端确保不提交空值
3. 使用中间件预处理请求，将空字符串转换为 null

文件数组绑定的特殊处理

另一个常见问题是 IFormFile[] 数组类型的绑定。默认情况下，表单绑定不支持直接将多个文件绑定到 IFormFile[] 数组，而是需要使用 IFormFileCollection 类型。

IFormFileCollection 是 ASP.NET Core 提供的专门用于处理多文件上传的强类型 API。它会自动收集请求中的所有文件，开发者可以通过索引或名称访问特定文件。

如果需要使用数组形式，可以有以下解决方案：

1. 直接使用 IFormFileCollection 类型
2. 实现自定义模型绑定器，将 IFormFileCollection 转换为数组
3. 在模型类中添加转换逻辑

最佳实践建议

1. 对于文件上传，优先使用 IFormFileCollection 而非数组
2. 处理可空值类型时，考虑升级到 .NET 10 或实现自定义绑定逻辑
3. 复杂表单场景下，考虑实现 BindAsync 方法提供更灵活的控制
4. 始终验证用户输入，特别是文件类型和大小

理解这些绑定行为有助于开发者在 Minimal API 中更高效地处理表单数据，构建更健壮的 Web 应用程序。