如何将MixCloud上传接口CURL请求转换为可正常运行的VB.NET代码

报错根因说明 #

大部分场景下返回400坏请求，都是没有正确构造符合要求的multipart/form-data格式请求：

• 手动拼接请求体时，请求头中声明的boundary值和实际分隔内容的边界字符串不匹配
• 没有严格对齐curl示例的字段命名规则，尤其是带数组下标的tags、sections类参数
• 错误将access_token放到请求头或表单字段中（接口要求token必须放在URL查询参数中）
• 上传的mp3文件没有携带正确的文件名、MIME类型标识，被服务端识别为无效文件
• 表单字段编码不匹配，出现中文乱码被服务端拦截

推荐实现（基于HttpClient，避免手动拼接格式错误） #

注：该实现完全对齐curl -F参数的表单逻辑，框架自动处理边界、编码等格式问题，规避90%以上的格式类坏请求
首先需要导入必要的命名空间：

Imports System.Net.Http
Imports System.IO
Imports System.Text

核心上传代码如下：

Async Function UploadToMixCloud(accessToken As String, localMp3Path As String) As Task(Of String)
    ' 建议全局初始化复用HttpClient实例，避免每次新建造成socket资源耗尽
    Using client As New HttpClient()
        ' 构造请求URL，严格将access_token放在查询参数中
        Dim requestUrl As New Uri($"https://api.mixcloud.com/upload/?access_token={accessToken}")
        
        ' 构造multipart表单内容
        Using formContent As New MultipartFormDataContent()
            ' 添加普通文本字段，严格对齐curl的字段名，指定UTF8编码避免乱码
            formContent.Add(New StringContent("API Upload", Encoding.UTF8, "text/plain"), "name")
            formContent.Add(New StringContent("Test", Encoding.UTF8, "text/plain"), "tags-0-tag")
            formContent.Add(New StringContent("API", Encoding.UTF8, "text/plain"), "tags-1-tag")
            formContent.Add(New StringContent("Introduction", Encoding.UTF8, "text/plain"), "sections-0-chapter")
            formContent.Add(New StringContent("0", Encoding.UTF8, "text/plain"), "sections-0-start_time")
            formContent.Add(New StringContent("Artist Name", Encoding.UTF8, "text/plain"), "sections-1-artist")
            formContent.Add(New StringContent("Song Title", Encoding.UTF8, "text/plain"), "sections-1-song")
            formContent.Add(New StringContent("10", Encoding.UTF8, "text/plain"), "sections-1-start_time")
            formContent.Add(New StringContent("My test upload", Encoding.UTF8, "text/plain"), "description")
            
            ' 添加mp3文件字段，严格对齐curl的mp3字段名
            Dim fileStream As FileStream = File.OpenRead(localMp3Path)
            Dim fileContent As New StreamContent(fileStream)
            ' 指定文件的MIME类型，否则服务端可能识别不到
            fileContent.Headers.ContentType = New System.Net.Http.Headers.MediaTypeHeaderValue("audio/mpeg")
            ' 必须传入文件名，和curl的@upload.mp3对应
            formContent.Add(fileContent, "mp3", Path.GetFileName(localMp3Path))
            
            ' 发起上传请求
            Using response As HttpResponseMessage = Await client.PostAsync(requestUrl, formContent)
                ' 读取返回结果
                Return Await response.Content.ReadAsStringAsync()
            End Using
        End Using
    End Using
End Function

关键注意事项 #

• 所有表单字段的名称必须和官方示例完全一致，包括连字符、数字下标的格式，不要自行修改
• 添加文件字段时必须传入对应本地文件名，否则生成的表单头里会出现空文件名，直接触发服务端坏请求
• 上传的mp3文件需要符合接口的大小、格式要求，文件损坏同样会返回400错误
• 如果仍出现400错误，可通过抓包工具对比生成的请求和curl示例请求的差异，重点检查边界符、字段值、文件头部分的格式

排错校验方法 #

可直接在本地执行带详细日志的curl命令，将curl生成的请求体和代码生成的请求体逐行对比：

curl -v -F mp3=@upload.mp3 \
     -F "name=API Upload" \
     -F "tags-0-tag=Test" \
     -F "tags-1-tag=API" \
     -F "sections-0-chapter=Introduction" \
     -F "sections-0-start_time=0" \
     -F "sections-1-artist=Artist Name" \
     -F "sections-1-song=Song Title" \
     -F "sections-1-start_time=10" \
     -F "description=My test upload" \
     https://api.mixcloud.com/upload/?access_token=你的访问令牌

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