服务器响应 406 Not Acceptable

HTTP 状态码 406 (Not Acceptable)

HTTP 状态码 406 表示服务器无法提供客户端在 Accept 头中指定的格式的响应。这种情况可能由多种因素造成，包括请求头不正确或服务器不支持请求的格式。

定义与主要原因

状态码 406 通常表示请求的内容类型未被接受。
客户端可能请求了服务器不支持的媒体类型。
请求中的 Accept 头可能包含无效的格式。

客户端可能遇到的情况

尝试访问特定资源时，返回的内容类型与客户端期望的不匹配。
使用第三方 API 时，未正确设置 Accept 头导致的错误。
在多媒体内容请求中，指定了服务器不支持的文件格式。

406 与其他状态码的区别

状态码 406 与其他状态码（如 415 Unsupported Media Type）有所不同。状态码 415 表示请求的媒体类型未被支持，而 406 则表示请求的内容类型未被接受，即使媒体类型可能是有效的。

实际示例

示例 1: 请求不支持的图像格式

客户端请求服务器返回 PNG 格式的图像，但服务器仅支持 JPEG 格式，因此返回状态码 406。

示例 2: 请求文本文档的错误格式

客户端发出请求，期望返回 XML 文档，但服务器只能返回 JSON 格式，导致状态码 406。

示例 3: 错误的 Accept 头导致 406

客户端在请求中设置了 Accept: text/, application/xml，但服务器只能返回纯文本格式，因而返回状态码 406。

不同编程语言中修复错误的方法

JavaScript (Node.js)

以下代码示例中，当请求的格式不被支持时，可能会出现状态码 406。


const express = require('express');
const app = express();

app.get('/example', (req, res) => {
    res.format({
        'application/json': () => {
            res.send({ message: 'This is JSON response.' });
        },
        'text/plain': () => {
            res.send('This is a plain text response.');
        },
        default: () => {
            res.status(406).send('Not Acceptable');
        }
    });
});

修复方法：确保请求中的 Accept 头正确设置为服务器支持的格式。

Python (Flask)

在 Flask 中，当调用一个返回状态码 406 的 API 时，可能是因为请求的格式不被支持。


from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api', methods=['GET'])
def api():
    if 'application/json' in request.headers.get('Accept', ''):
        return jsonify(message='This is a JSON response.')
    else:
        return 'Not Acceptable', 406

修复方法：添加对请求格式的支持，确保 API 能够处理多种响应格式。

PHP

在 PHP 中，发送请求时可能会遇到状态码 406。


<?php
header('Content-Type: application/json');
if ($_SERVER['HTTP_ACCEPT'] !== 'application/json') {
    http_response_code(406);
    echo 'Not Acceptable';
} else {
    echo json_encode(['message' => 'This is a JSON response.']);
}
?>

修复方法：调整请求头或确保路由设置以支持请求的格式。

预防状态码 406 的建议

在发送请求之前检查 Accept 头是否正确。
配置服务器以支持多种响应格式。
使用不同的请求参数测试 API 功能。

状态码 406 的实际应用

状态码 406 对开发人员有帮助，因为它提供了有关请求内容类型的信息，促使他们检查和修复请求头。同时，API 用户可以根据返回的状态码指导他们的请求，以确保获得所需的响应格式。

正确处理 Accept 头对于确保客户端和服务器之间的良好交互至关重要。开发人员应当重视响应格式的支持，以提高 API 的可用性和用户体验。

附加代码

代码	描述
406.0	不可接受 - 请求的 MIME 类型不可接受。