ASP.NET控制器中解析含File的Dictionary<string,Object>异常解决

问题原因 #

ASP.NET默认的FormData模型绑定逻辑中，会将每个键对应的所有值封装为列表（因为FormData支持同一键多次提交），所以你的Dictionary(Of String, Object)会被解析成值为单元素列表的字典，而非预期的单个值或文件。

解决方案 #

1. 自定义模型绑定器（推荐） #

写一个针对Dictionary(Of String, Object)的自定义绑定器，手动处理FormData中的键值对，将单元素列表转为单个值，同时识别并绑定文件：

Imports Microsoft.AspNetCore.Mvc.ModelBinding
Imports Microsoft.AspNetCore.Http

Public Class FormDataDictionaryBinder
    Implements IModelBinder

    Public Async Function BindModelAsync(context As ModelBindingContext) As Task Implements IModelBinder.BindModelAsync
        If context Is Nothing Then
            Throw New ArgumentNullException(NameOf(context))
        End If

        Dim formCollection = Await context.HttpContext.Request.ReadFormAsync()
        Dim resultDict As New Dictionary(Of String, Object)

        For Each key In formCollection.Keys
            Dim values = formCollection(key)
            If values.Count = 1 Then
                ' 尝试判断是否为文件
                Dim files = context.HttpContext.Request.Form.Files.GetMultiple(key)
                If files.Any() Then
                    resultDict(key) = files.First()
                Else
                    ' 基本类型直接取第一个值
                    resultDict(key) = values(0)
                End If
            Else
                ' 如果有多个值，保留列表（根据你的需求调整）
                resultDict(key) = values
            End If
        Next

        context.Result = ModelBindingResult.Success(resultDict)
    End Function
End Class

然后在参数上应用这个绑定器：

<HttpPost>
Sub SavePortalRecord(ReportID As Integer, <ModelBinder(BinderType:=GetType(FormDataDictionaryBinder))> JsonInput As Dictionary(Of String, Object), RecordID As Integer?)
    ' 处理逻辑
End Sub

2. 改用强类型DTO（更稳妥） #

如果你的字典结构相对固定，建议定义一个DTO类，明确字段类型，文件用IFormFile：

Public Class PortalRecordDto
    Public Property ReportID As Integer
    Public Property RecordID As Integer?
    Public Property Field1 As String ' 对应原字典的基本类型键
    Public Property Field2 As Integer
    Public Property Attachment As IFormFile ' 对应文件字段
    ' 其他需要的字段
End Class

然后修改接口方法：

<HttpPost>
Sub SavePortalRecord(dto As PortalRecordDto)
    ' 处理逻辑
End Sub

客户端提交FormData时，直接对应字段名即可，模型绑定会自动识别基本类型和文件，避免字典解析的问题。

3. 手动解析FormCollection #

如果不想改模型结构，也可以直接在方法中接收IFormCollection，自己构建字典：

<HttpPost>
Sub SavePortalRecord(ReportID As Integer, RecordID As Integer?)
    Dim form = Request.Form
    Dim jsonInput As New Dictionary(Of String, Object)

    For Each key In form.Keys
        ' 排除已单独接收的参数
        If key = "ReportID" Or key = "RecordID" Then Continue For

        Dim files = form.Files.GetMultiple(key)
        If files.Any() Then
            jsonInput(key) = files.First()
        Else
            jsonInput(key) = form(key)(0)
        End If
    Next

    ' 后续处理逻辑
End Sub

注意事项 #

• 客户端提交FormData时，确保文件字段的名称和服务端对应键名一致，基本类型字段直接用键值对提交即可，不需要额外嵌套。
• 如果字典中存在嵌套结构，自定义绑定器需要额外处理嵌套的FormData键命名（比如用ParentKey.ChildKey的格式），但如果是扁平化结构，上述方法足够。

内容的提问来源于stack exchange，提问作者Yisroel M. Olewski