在Liferay资源Portlet中用Spring ResponseEntity输出文件流遇阻求助

你这情况踩了Ajax处理文件下载的经典坑——Ajax请求本身不会触发浏览器的下载弹窗/行为，哪怕后端返回了正确的二进制数据，浏览器也只会把数据存在内存里，不会主动处理成可下载的文件。结合你的Spring + Liferay场景，给你几个针对性的解决方案：

1. 优先换用非Ajax方式（最简单可靠） #

直接跳过Ajax，用动态生成的<a>标签或者隐藏表单来请求资源portlet，这是最不容易出问题的方式：

动态a标签方案（适合无复杂参数的情况） #

// 替换成你的resource portlet请求URL和参数
const downloadUrl = '/o/your-resource-portlet/download?fileId=123';
const a = document.createElement('a');
a.href = downloadUrl;
// 指定下载文件名，可选但建议添加
a.download = 'target-file.pdf';
// 触发点击后移除临时标签
document.body.appendChild(a);
a.click();
document.body.removeChild(a);

隐藏表单方案（适合需要POST传递复杂参数的情况） #

const form = document.createElement('form');
form.method = 'POST';
form.action = '/o/your-resource-portlet/download';
form.style.display = 'none';

// 添加需要传递的参数
const fileIdInput = document.createElement('input');
fileIdInput.type = 'hidden';
fileIdInput.name = 'fileId';
fileIdInput.value = '123';
form.appendChild(fileIdInput);

document.body.appendChild(form);
form.submit();
document.body.removeChild(form);

2. 必须用Ajax时的处理方式（需转换Blob） #

如果业务上必须先通过Ajax完成前置逻辑，那可以把后端返回的二进制数据转换成Blob，再动态生成下载链接：

fetch('/o/your-resource-portlet/download?fileId=123')
  .then(response => response.blob())
  .then(blob => {
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'target-file.pdf';
    document.body.appendChild(a);
    a.click();
    // 释放URL对象，避免内存泄漏
    window.URL.revokeObjectURL(url);
    document.body.removeChild(a);
  })
  .catch(error => console.error('下载失败:', error));

注意：这种方式需要后端正确设置Content-Type和Content-Disposition头，否则Blob的类型可能不正确，影响浏览器识别。

3. Liferay Resource Portlet端的关键配置（重中之重） #

你后端的问题大概率是响应头没设置对，或者用了不合适的返回方式。在serveResource方法里，不要用ResponseEntity，直接操作PortletResponse的输出流：

@Override
public void serveResource(ResourceRequest request, ResourceResponse response) throws PortletException, IOException {
    // 1. 从后端获取流式文件数据
    RestTemplate restTemplate = new RestTemplate();
    String backendUrl = "http://your-backend/api/file-stream";
    Resource fileResource = restTemplate.getForObject(backendUrl, Resource.class);

    // 2. 设置核心响应头（必须！）
    response.setContentType("application/octet-stream");
    response.setProperty(ResourceResponse.HEADER_CONTENT_DISPOSITION, 
        "attachment; filename=\"downloaded-file.pdf\"");
    // 可选：设置内容长度，提升浏览器下载体验
    response.setContentLength((int) fileResource.contentLength());

    // 3. 流式写入数据到响应输出流
    try (InputStream in = fileResource.getInputStream();
         OutputStream out = response.getPortletOutputStream()) {
        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
        out.flush();
    }
}

为什么不用ResponseEntity？因为Liferay的Resource Portlet有自己的响应处理机制，直接返回ResponseEntity可能导致框架覆盖或忽略你设置的响应头，尤其是Content-Disposition——这个头是触发浏览器下载行为的核心！

4. RestTemplate流式获取数据的优化（大文件场景） #

如果后端文件很大，建议用RestTemplate的流式处理，避免把整个文件加载到内存：

// 使用RequestCallback和ResponseExtractor直接流式传输
restTemplate.execute(backendUrl, HttpMethod.GET, null, response -> {
    try (InputStream in = response.getBody();
         OutputStream out = response.getPortletOutputStream()) {
        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
        out.flush();
    }
    return null;
});

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