哪些ColdFusion服务器设置会影响superagent GET请求的内容类型？

我们部署了两台Adobe ColdFusion服务器：生产环境为ColdFusion 2018，开发环境为ColdFusion 2021。升级开发服务器时手动迁移管理员面板设置，可能遗漏了部分配置，导致某Web应用通过superagent调用REST API时出现问题：生产环境返回的content-type为application/json，开发环境却返回text/plain，下游代码因依赖response.body解析数据而异常（此时response.body为null，只能用response.text，但文本格式也不符合解析要求）。

相关前端代码片段：

export const makeGetRequest = (url, callback) => {
    window.pendingRequests ? ++window.pendingRequests : window.pendingRequests = 1;
    request
        .get(url)
        .set('Content-Type', 'application/json')
        .end((err, response) => {
            --window.pendingRequests;
            const data = response.body;
            if (data === null) {
                console.log(url);
            }
            if (err) callback(err);
             else if (data && data.Message) callback(new Error(data.Message));
             else callback(null, data);
        });
};

注：前端手动设置Content-Type请求头无效；改用response.text替代response.body时，内容仍无法正确解析。

优先检查ColdFusion管理员面板的关键配置项 #

1. REST服务全局配置 #

• 进入ColdFusion管理员 → 服务 → REST服务
• 确认「默认响应格式」设置为JSON，开发环境可能遗漏了这个配置
• 检查「响应内容类型映射」中，JSON对应的Content-Type是否为application/json，而非text/plain

2. JSON序列化全局设置 #

• 进入ColdFusion管理员 → 设置 → 序列化
• 找到「JSON输出的MIME类型」选项，确认值为application/json，部分版本默认可能为text/plain或未配置

3. 单个REST服务的自定义配置 #

如果只有特定接口出现问题，检查对应REST服务的部署配置：

• 在REST服务页面找到目标服务，点击「编辑」
• 查看「响应格式」和「内容类型」是否继承全局配置，避免被手动设置为text/plain

4. MIME类型映射配置 #

• 进入ColdFusion管理员 → 服务器设置 → MIME类型
• 查找.json对应的MIME类型，确保是application/json，若缺失则手动添加

代码层面临时兼容方案（优先改服务器配置） #

如果暂时找不到配置问题，可以修改前端代码兼容两种响应类型：

export const makeGetRequest = (url, callback) => {
    window.pendingRequests ? ++window.pendingRequests : window.pendingRequests = 1;
    request
        .get(url)
        .set('Accept', 'application/json') // 告诉服务器我们接受JSON格式响应
        .end((err, response) => {
            --window.pendingRequests;
            let data = null;
            try {
                // 优先用response.body，失败则尝试解析response.text
                data = response.body || JSON.parse(response.text.trim());
            } catch (parseErr) {
                console.error(`解析${url}数据失败:`, parseErr);
            }
            if (data === null) {
                console.log(url);
            }
            if (err) callback(err);
             else if (data && data.Message) callback(new Error(data.Message));
             else callback(null, data);
        });
};

注意：GET请求设置Content-Type意义不大，换成Accept请求头更合理，明确告知服务器期望的响应格式。

对已尝试方案的补充说明 #

1. 手动设置响应头无效：需要在ColdFusion后端代码中设置响应头（比如<cfheader name="Content-Type" value="application/json">），而非前端请求头；或者服务器配置强制覆盖了响应头
2. response.text解析失败：可能是ColdFusion序列化JSON时产生了多余空格、BOM或格式错误，检查序列化设置中的「美化输出」是否开启，开启可能导致格式问题

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