在 nginx 中配置 uwsgi 模块代理 python 应用，核心做法是启用 uwsgi_pass 指令并将请求转发至 uwsgi 服务器监听的 unix 套接字或 tcp 端口。具体操作是在 location 块中设置 uwsgi_pass 指向后端地址，并引入 uwsgi_params 文件以传递标准环境变量，同时通过 include 指令加载该参数文件，这样 nginx 就能将 http 请求转换为 uwsgi 协议发送给 python 应用。
Nginx 如何建立与 UWSGI 后端的连接通道
Nginx 通过 uwsgi_pass 指令指定 UWSGI 服务器的地址来建立连接通道。这个地址可以是本地文件系统上的 Unix 域套接字路径，也可以是 IP 地址加端口的组合。使用 Unix 套接字通常性能更高且更安全，因为它避免了网络栈的开销；而 TCP 端口则适用于 Nginx 和 UWSGI 部署在不同主机或容器中的场景。无论选择哪种方式，Nginx 都会作为客户端向该地址发起连接，并将处理后的请求数据发送过去。
server {
listen 80;
server_name example.com;
location / {
# 指定 UWSGI 服务器地址，这里使用 Unix 套接字
uwsgi_pass unix:/tmp/your_app.sock;
# 包含标准的 UWSGI 参数文件
include uwsgi_params;
# 可选：设置超时时间
uwsgi_read_timeout 60s;
}
}
UWSGI 参数文件在请求转发中起什么作用
UWSGI 参数文件（通常为 uwsgi_params）定义了 Nginx 需要传递给 UWSGI 服务器的环境变量集合。这些变量包括 SCRIPT_NAME、REQUEST_URI、QUERY_STRING 等，它们构成了 WSGI 规范所要求的 environ 字典。如果没有包含这个文件，UWSGI 将无法正确解析请求的路径、方法、头部信息等关键数据，导致应用报错或行为异常。因此，include uwsgi_params; 是确保请求语义正确传递的必要步骤。
# uwsgi_params 内容示例 uwsgi_param QUERY_STRING $query_string; uwsgi_param REQUEST_METHOD $request_method; uwsgi_param CONTENT_TYPE $content_type; uwsgi_param CONTENT_LENGTH $content_length; uwsgi_param REQUEST_URI $request_uri; uwsgi_param PATH_INFO $document_uri; uwsgi_param DOCUMENT_ROOT $document_root; uwsgi_param SERVER_PROTOCOL $server_protocol; uwsgi_param REQUEST_SCHEME $scheme; uwsgi_param HTTPS $https if_not_empty; uwsgi_param REMOTE_ADDR $remote_addr; uwsgi_param REMOTE_PORT $remote_port; uwsgi_param SERVER_PORT $server_port; uwsgi_param SERVER_NAME $server_name;
当 UWSGI 套接文件不存在时 Nginx 会返回什么错误
如果配置的 uwsgi_pass 指向的 Unix 套接字文件不存在，或者 UWSGI 进程未启动导致无法监听该套接字，Nginx 将无法建立连接。此时，Nginx 通常会返回 502 Bad Gateway 错误。这是因为 Nginx 作为反向代理，在尝试连接后端服务失败时，默认会将此状态码返回给客户端。要验证这一点，可以故意删除 /tmp/your_app.sock 文件或停止 UWSGI 服务，然后访问对应的 URL，观察浏览器是否显示 502 错误页面，并检查 Nginx 的错误日志中是否有 connect() to unix:/tmp/your_app.sock failed (2: No such file or directory) 类似的记录。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
