Play for Scala中用Ok()下载二进制文件指定MIME类型及异常排查

嘿，我来帮你搞定这个问题！先从基础的设置MIME类型说起，再排查你遇到的返回JSON的奇怪问题。

给二进制数组指定MIME类型的正确写法 #

你原来的代码只是返回了字节数组，但没告诉Play这是什么类型的文件，所以它会用默认的通用类型。要指定MIME类型，只需要在Ok后面链式调用as方法，传入对应的MIME字符串就行：

class Test extends Controller {
  def test = Action { request =>
    val byteArray = Files.readAllBytes(Paths.get("path/to/file.jpeg"))
    // 显式指定图片的MIME类型
    Ok(byteArray).as("image/jpeg")
  }
}

不同文件对应不同的MIME类型，比如PNG用"image/png"，PDF用"application/pdf"，你可以根据自己的文件类型替换。

使用sendFile的正确姿势 #

如果直接操作文件而不是字节数组，sendFile也能指定MIME类型，两种方式：

1. 显式指定：

class Test extends Controller {
  def test = Action { request =>
    val targetFile = new File("path/to/file.jpeg")
    Ok.sendFile(
      content = targetFile,
      contentType = Some("image/jpeg")
    )
  }
}

2. 让Play自动根据文件扩展名推断：

import play.api.libs.MimeTypes

class Test extends Controller {
  def test = Action { request =>
    val targetFile = new File("path/to/file.jpeg")
    val contentType = MimeTypes.forFileName(targetFile.getName)
      .getOrElse("application/octet-stream") // 兜底的通用二进制类型
    Ok.sendFile(targetFile, contentType = Some(contentType))
  }
}

排查你遇到的“返回JSON”问题 #

你说用as和sendFile都返回JSON，这大概率不是方法本身的问题，可能是这些原因：

• 请求头的干扰：检查前端请求是不是带了Accept: application/json的请求头？虽然as应该强制覆盖响应类型，但某些全局配置可能会干扰。可以用Postman或者curl不带任何Accept头测试一下。
• 全局拦截器/过滤器修改响应：看看你的项目里有没有全局的Action包装器、过滤器，是不是统一把响应类型设置成了JSON？比如某些统一处理响应的逻辑可能会覆盖你设置的Content-Type。
• 文件路径错误：如果目标文件不存在，Play可能会返回一个JSON格式的错误响应（比如404的JSON提示），而不是你预期的文件。建议加个文件存在性检查：

val targetFile = new File("path/to/file.jpeg")
if (targetFile.exists() && targetFile.isFile) {
  Ok.sendFile(targetFile).as("image/jpeg")
} else {
  NotFound("目标文件不存在")
}

• 拼写错误：检查MIME类型字符串有没有写错，比如把image/jpeg写成image/jpg（虽然大部分浏览器能识别，但标准写法是前者），或者as方法有没有拼写错误？

从你发的截图来看，响应是JSON格式，很可能是文件找不到导致的错误响应，你可以看看JSON里的具体内容，应该能找到线索！

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