Kotlin中MultipartBody.Part与RequestBody上传PNG图片报错求助

我正在用Kotlin开发一款考勤应用，尝试将自拍图片作为考勤凭证上传至后端。使用MultipartBody.Part传输图片文件，RequestBody传输其他字段，定义的接口如下：

@Multipart
@POST("shiftentry/clockin")
suspend fun clockin(
    @Header("Authorization") auth: String,
    @Part("shift_entry_id") id: RequestBody,
    @Part("location") location:RequestBody,
    @Part file: MultipartBody.Part
): Response<Clocking>

拍照后图片保存为文件，点击按钮时执行上传逻辑：

button.setOnClickListener {
    val repository = Repository()
    val shiftingViewModelFactory = ShiftingViewModelFactory(repository)
    val fotoBody = photoSelfie.asRequestBody("image/png".toMediaTypeOrNull())
    val foto = MultipartBody.Part.createFormData("selfie",photoSelfie.name,fotoBody)
    val id = entry.toRequestBody("text/plain".toMediaTypeOrNull())
    val loc = locationSpec.toRequestBody("text/plain".toMediaTypeOrNull())

    viewModel = ViewModelProvider(this, shiftingViewModelFactory).get(ShiftingViewModel::class.java)

    loginpref.fetchToken()?.let { viewModel.clockin(it, id, loc, foto) }

    viewModel.clocking.observe(this) { response ->
        if (response.isSuccessful) {
            val intent= Intent(this, VerificationActivity::class.java)
            startActivity(intent)
        }
    }
}

代码无语法错误，但上传时返回400错误（unexpected field）。若仅用RequestBody传输图片，服务器提示未包含文件。另外请求中出现大量无法识别的字符，请教以下问题：

1. 需要修复哪部分代码？
2. 除了RequestBody和MultipartBody.Part，还有其他文件上传方式吗？
3. 请求中的乱码是什么？

问题解答 #

1. 需要修复的代码部分 #

400错误提示unexpected field，核心原因是后端期望的字段名和你前端传递的不匹配，或者字段格式不符合要求，重点检查这几点：

• 检查图片字段名：你用createFormData("selfie", ...)定义了图片字段名为selfie，要确认后端接口文档里是否要求这个字段名，比如后端可能期望的是file、photo之类的，名字不对就会报“意外字段”。
• 普通字段的@Part注解写法：当前用@Part("shift_entry_id") id: RequestBody传递普通字段，这种写法在OkHttp中可能会导致字段的Content-Type设置不规范，建议改成把普通字段也用MultipartBody.Part来构建，比如：

  val idPart = MultipartBody.Part.createFormData("shift_entry_id", entry)
  val locPart = MultipartBody.Part.createFormData("location", locationSpec)
  

  然后接口参数改成：

  @Multipart
  @POST("shiftentry/clockin")
  suspend fun clockin(
      @Header("Authorization") auth: String,
      @Part idPart: MultipartBody.Part,
      @Part locPart: MultipartBody.Part,
      @Part file: MultipartBody.Part
  ): Response<Clocking>
  

• 图片的Media-Type验证：确保photoSelfie确实是PNG格式，如果是JPG，要改成"image/jpeg".toMediaTypeOrNull()，否则后端解析文件时可能出错。

2. 其他文件上传方式 #

除了RequestBody和MultipartBody.Part的多表单上传，还有两种常见方式：

• 字节流直接上传：把图片文件转换成字节数组，用RequestBody包裹后直接作为请求体发送，这种方式需要后端支持接收原始字节流，接口定义如下：

  @POST("shiftentry/clockin")
  suspend fun clockin(
      @Header("Authorization") auth: String,
      @Header("Content-Type") contentType: String,
      @Body body: RequestBody
  ): Response<Clocking>
  

  构建请求体时：

  val body = photoSelfie.asRequestBody("image/png".toMediaTypeOrNull())
  

  但这种方式没法同时传递其他字段，需要把字段放在请求头或者URL参数里。
• Base64编码上传：将图片转换成Base64字符串，作为普通字符串字段和其他参数一起用@Body发送，比如：

  // 先把图片转成Base64
  val bitmap = BitmapFactory.decodeFile(photoSelfie.path)
  val baos = ByteArrayOutputStream()
  bitmap.compress(Bitmap.CompressFormat.PNG, 100, baos)
  val base64Str = Base64.encodeToString(baos.toByteArray(), Base64.DEFAULT)
  
  // 定义请求数据类
  data class ClockinRequest(
      val shift_entry_id: String,
      val location: String,
      val selfie: String // Base64字符串
  )
  
  @POST("shiftentry/clockin")
  suspend fun clockin(
      @Header("Authorization") auth: String,
      @Body request: ClockinRequest
  ): Response<Clocking>
  

  这种方式不用处理多表单，但Base64会让数据体积增大30%左右，上传速度变慢。

3. 请求中的乱码是什么 #

你看到的“无法识别的字符”是Multipart请求的边界分隔符和文件二进制内容：

• Multipart表单请求会用一串随机生成的字符串（边界符）分隔每个字段，这串字符看起来像乱码，比如--abc123def。
• 图片是二进制文件，本身不是可打印字符，在请求日志里显示出来就是乱码，这是正常现象，不是编码错误，只要后端正确解析Multipart请求就能正常读取图片。

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