如何在ColdFusion REST接口的GET方法中同时返回JSON与附件文件？

你当前的代码之所以会把JSON和PDF内容混在一起输出，核心原因是HTTP协议一次请求只能返回一种类型的响应内容，没办法同时在同一个响应里既返回JSON数据，又提供可下载的文件。你现在的做法相当于把两种完全不同格式的内容拼接在一起，浏览器自然无法正确解析，只会把它们当成一个整体输出。

可行的解决方案 #

推荐用以下两种方式实现需求：

方式1：返回JSON包含文件下载链接（最常用、兼容性最好）

修改原REST方法，只返回JSON数据，在JSON里新增一个下载链接字段，指向另一个专门负责返回文件的REST端点。前端拿到JSON后，通过这个链接触发文件下载（比如创建<a>标签跳转，或者用JS发起请求下载）。

示例代码：

// 原GET方法修改：只返回带下载链接的JSON
outputPayload.downloadUrl = "/api/documents/#payloadIn.documentKey#"; 
// 假设你的API前缀是/api，新增的文件下载端点路径是/documents/{documentKey}

getpagecontext().getresponse().setStatus(JavaCast('int', 200), "OK");
cfcontent(type="application/json");
writeOutput(serializeJSON(outputPayload));

// 新增一个专门处理文件下载的REST组件方法
component restpath="/documents" {
    remote any function downloadDocument(required string documentKey) 
        restmethod="GET" 
        produces="application/pdf" {
        
        // 根据documentKey获取文件内容和文件名
        var documentData = getDocumentByKey(documentKey); // 自定义方法，返回文件二进制
        var fileName = documentData.name & ".pdf";
        
        // 设置响应头，触发下载
        cfheader(name="Content-Disposition", value="attachment;filename=#fileName#");
        cfcontent(type="application/pdf", variable=documentData.content);
    }
}

方式2：多部分响应（不推荐，浏览器兼容性差）

HTTP协议支持多部分响应，但绝大多数浏览器不会自动处理这种响应——它们既不会自动显示JSON内容，也不会自动触发文件下载，前端需要编写额外的解析逻辑，复杂度很高，实际项目中几乎不会用这种方式，所以不推荐尝试。

原代码问题拆解 #

你原代码里先设置了application/json的内容类型，输出JSON后又设置Content-Disposition头并输出PDF二进制，这相当于把两种格式的内容强行塞到同一个响应体里，浏览器无法识别这种混合内容，就会直接把它们拼接起来显示，也就是你看到的JSON后面跟着乱码PDF的情况。

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