原生Android中如何以multipart/formdata方式上传音频与图片？

别慌，我来一步步带你搞定这个multipart上传的事儿——这玩意儿确实容易在细节上卡壳，我当初第一次弄也折腾了好久。

先明确你的上传需求 #

你需要上传的Form Data字段如下：

字段类型说明：

• ApiKey、userid、albumid、music_name、singer_name为文本类型字段；
• music_cover对应图片文件，music_file对应音频文件。

所有字段均为非空字段，必须传递所有值至服务端才能获取成功响应。

你已经拿到了图片和音频的文件路径，接下来直接上完整实现步骤：

1. 准备依赖（用OkHttp实现，最常用的网络库） #

首先确保你的项目引入了OkHttp，在build.gradle(Module level)的dependencies块中添加：

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

同步项目拉取依赖即可。

2. 核心上传代码实现 #

我给你写一个可直接复用的工具类，包含文件校验、请求构建、异步请求全流程：

Kotlin版本 #

import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.MultipartBody
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.asRequestBody
import java.io.File
import java.util.concurrent.TimeUnit

class MusicUploadHelper {
    // 配置OkHttp客户端，设置超时时间避免请求挂死
    private val okHttpClient = OkHttpClient.Builder()
        .connectTimeout(30, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.SECONDS)
        .writeTimeout(30, TimeUnit.SECONDS)
        .build()

    // 上传方法，参数传入所有必填字段和文件路径，回调返回结果
    fun uploadMusic(
        apiKey: String,
        userId: String,
        albumId: String,
        musicName: String,
        singerName: String,
        coverPath: String,
        musicFilePath: String,
        onUploadResult: (Boolean, String) -> Unit
    ) {
        // 先校验文件是否存在，避免无效请求
        val coverFile = File(coverPath)
        val musicFile = File(musicFilePath)
        if (!coverFile.exists() || !musicFile.exists()) {
            onUploadResult(false, "图片或音频文件不存在，请检查路径")
            return
        }

        // 构建Multipart请求体，严格对应服务端字段名
        val requestBody = MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            // 添加文本字段
            .addFormDataPart("ApiKey", apiKey)
            .addFormDataPart("userid", userId)
            .addFormDataPart("albumid", albumId)
            .addFormDataPart("music_name", musicName)
            .addFormDataPart("singer_name", singerName)
            // 添加图片文件，MediaType可根据实际文件类型调整（比如image/png）
            .addFormDataPart(
                "music_cover",
                coverFile.name,
                coverFile.asRequestBody("image/*".toMediaTypeOrNull())
            )
            // 添加音频文件，同理可改为audio/mpeg等具体类型
            .addFormDataPart(
                "music_file",
                musicFile.name,
                musicFile.asRequestBody("audio/*".toMediaTypeOrNull())
            )
            .build()

        // 构建完整请求
        val request = Request.Builder()
            .url("你的服务端上传接口地址") // 替换成实际接口URL
            .post(requestBody)
            .build()

        // 异步执行请求，避免阻塞主线程
        okHttpClient.newCall(request).enqueue(object : okhttp3.Callback {
            override fun onFailure(call: okhttp3.Call, e: java.io.IOException) {
                onUploadResult(false, "上传失败：${e.message}")
            }

            override fun onResponse(call: okhttp3.Call, response: okhttp3.Response) {
                val responseContent = response.body?.string() ?: ""
                if (response.isSuccessful) {
                    onUploadResult(true, "上传成功，服务端响应：$responseContent")
                } else {
                    onUploadResult(false, "上传失败，服务端返回码：${response.code}，内容：$responseContent")
                }
            }
        })
    }
}

Java版本核心片段（逻辑一致） #

// 构建Multipart请求体
MultipartBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("ApiKey", apiKey)
        .addFormDataPart("userid", userId)
        .addFormDataPart("albumid", albumId)
        .addFormDataPart("music_name", musicName)
        .addFormDataPart("singer_name", singerName)
        .addFormDataPart(
                "music_cover",
                coverFile.getName(),
                RequestBody.create(MediaType.parse("image/*"), coverFile)
        )
        .addFormDataPart(
                "music_file",
                musicFile.getName(),
                RequestBody.create(MediaType.parse("audio/*"), musicFile)
        )
        .build();

3. 权限配置（必加！） #

在AndroidManifest.xml中添加必要权限：

<!-- 网络权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 10-12 读取外部存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13+ 读取媒体文件权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

如果你的项目targetSdk≥33，记得动态申请READ_MEDIA_IMAGES和READ_MEDIA_AUDIO权限，不能直接依赖旧的存储权限。

4. 调用示例（在Activity中） #

val uploadHelper = MusicUploadHelper()
uploadHelper.uploadMusic(
    apiKey = "你的ApiKey",
    userId = "你的userid",
    albumId = "你的albumid",
    musicName = "测试音乐",
    singerName = "测试歌手",
    coverPath = "/storage/emulated/0/Pictures/cover.jpg", // 替换为实际图片路径
    musicFilePath = "/storage/emulated/0/Music/test.mp3" // 替换为实际音频路径
) { isSuccess, message ->
    // 切换到主线程更新UI
    runOnUiThread {
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
        if (isSuccess) {
            // 处理上传成功逻辑，比如跳转结果页
        } else {
            // 处理失败逻辑，比如重新上传
        }
    }
}

关键注意事项 #

• 字段名严格匹配：服务端要求的字段名（比如ApiKey）大小写、拼写必须完全一致，否则服务端会识别不到字段；
• MediaType准确：如果服务端指定了文件类型（比如必须是image/png或audio/mpeg），一定要替换成对应类型，不然可能被服务端拒绝；
• 避免主线程请求：必须用异步请求，否则会触发NetworkOnMainThreadException；
• 文件大小限制：如果文件过大，要确认服务端的大小限制，必要时做分块上传。

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