返回

深入解析：用 Nginx proxy_pass 代理转发 Node 服务时，带有 UTF-8 编码路径为何导致 404 错误？

前端

Nginx 作为一款备受青睐的 Web 服务器，以其高效、稳定和功能强大的特性而闻名。当需要将请求转发至后端服务时，proxy_pass 指令便派上了用场。然而，当涉及到 URL 中含有 UTF-8 编码字符的请求时，可能会遇到 404 错误。

让我们先从了解 URL 编码开始。URL 编码是一种将特殊字符（如空格、问号、百分号等）转换成十六进制编码格式的方法，以便在网络上传输时能够正确识别和处理。例如，空格会被编码为 "%20"。

在 Nginx 中，proxy_pass 指令用于将请求转发至后端服务。其基本语法如下：

proxy_pass http://backend-server-address:port;

其中，backend-server-address 为后端服务的主机地址，port 为后端服务的端口号。当 Nginx 收到一个请求时，它会根据 proxy_pass 指令将请求转发至后端服务。

当请求路径中包含 UTF-8 编码字符时，Nginx 会自动将这些字符解码为原始字符。但是，如果后端服务没有正确处理这些解码后的字符，就有可能导致 404 错误。

例如，假设我们有一个 Node.js 服务，它期望接收的路径为 "/path/to/resource"。如果我们通过 Nginx 将一个包含 UTF-8 编码字符的请求转发至该服务，例如 "/path/to/%E4%B8%AD%E6%96%87"，Nginx 会将 "%E4%B8%AD%E6%96%87" 解码为 "中文"。但是，如果 Node.js 服务没有正确处理 "中文" 这个字符串，就有可能返回 404 错误。

为了避免此类错误，我们可以采取以下解决方案：

  1. 在 Node.js 服务中正确处理 UTF-8 编码字符。
    我们可以使用 Node.js 内置的 decodeURIComponent() 函数来解码 UTF-8 编码的字符串。例如：
const decodedPath = decodeURIComponent(request.path);
  1. 在 Nginx 中使用 proxy_set_header 指令显式设置请求头。
    我们可以使用 proxy_set_header 指令显式设置请求头，以告知后端服务如何处理 UTF-8 编码字符。例如：
proxy_set_header Content-Type "application/json; charset=utf-8";

通过以上解决方案，我们可以确保 Nginx 和 Node.js 服务能够正确处理 UTF-8 编码字符，从而避免 404 错误的发生。