如何在nginx + uwsgi环境中使用environ['PATH_INFO']?

Question

我在 /www/app.py 写了一个简单的瓶子应用。

import bottle

app = bottle.Bottle()
@app.route('/')
def index():
    return 'hello from bottle'

application=app

我在一个叫 /etc/nginx/sites-enabled/foo 的文件里配置了 nginx 的虚拟主机：

server {
    listen 8080;
    root /www;
    index index.html index.htm;
    server_name foo;
    location / {
        uwsgi_pass 127.0.0.1:9090;
    }
}

我这样启动 nginx 和 uwsgi：

service nginx restart
uwsgi --socket 127.0.0.1:9090 --wsgi-file app.py

但是当我尝试访问 http://foo/ 时，网页上出现了这个错误：

Critical error while processing request: /

在 uwsgi 的输出中，我也看到了这个错误：

Traceback (most recent call last):
  File "/usr/local/lib/python3.3/dist-packages/bottle.py", line 954, in wsgi
    out = self._cast(self._handle(environ))
  File "/usr/local/lib/python3.3/dist-packages/bottle.py", line 845, in _handle
    path = environ['bottle.raw_path'] = environ['PATH_INFO']
KeyError: 'PATH_INFO'

我怀疑可能是 nginx 和 uwsgi 的环境没有给我的应用提供 environ['PATH_INFO'] 的值，所以我写了一个简单的 WSGI 应用来确认这个问题。我把 app.py 里的代码替换成了这个：

def application(environ, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    print('----- begun environ -----')
    for k, v in environ.items():
        print('environ[{}] = {}'.format(k, v))
    print('----- ended environ -----')
    return [b'<p>Hello World</p>']

果然，我在 uwsgi 的输出中没有看到 PATH_INFO：

----- begun environ -----
environ[uwsgi.version] = b'2.0.2'
environ[HTTP_ACCEPT_ENCODING] = gzip, deflate
environ[HTTP_CACHE_CONTROL] = max-age=0
environ[wsgi.multithread] = False
environ[HTTP_HOST] = foo:8080
environ[wsgi.input] = <uwsgi._Input object at 0x7f990a7019d8>
environ[wsgi.url_scheme] = http
environ[HTTP_USER_AGENT] = Mozilla/5.0 (Windows NT 6.1; WOW64; rv:27.0) Gecko/20100101 Firefox/27.0
environ[HTTP_ACCEPT_LANGUAGE] = en-US,en;q=0.5
environ[uwsgi.node] = b'nifty'
environ[wsgi.errors] = <_io.TextIOWrapper name=2 mode='w' encoding='UTF-8'>
environ[wsgi.multiprocess] = False
environ[wsgi.run_once] = False
environ[wsgi.version] = (1, 0)
environ[HTTP_CONNECTION] = keep-alive
environ[HTTP_ACCEPT] = text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
environ[wsgi.file_wrapper] = <built-in function uwsgi_sendfile>
----- ended environ -----

我该怎么做才能让我的应用或者瓶子应用获取到 environ['PATH_INFO'] 呢？

Answer 1

根据你使用的服务器平台，应该有一个叫做 uwsgi_params 的配置文件，这个文件会在你的 /etc/nginx 目录下设置一些参数。你可以像下面这样把它包含到你的 nginx 配置中：

server {
    listen 8080;
    root /www;
    index index.html index.htm;
    server_name foo;
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;
    }
}

---

如果你没有这个文件，下面是我本地 nginx 服务器的内容，可能也适合你使用：

menno@mimic:/etc/nginx$ nginx -v
nginx version: nginx/1.1.19

menno@mimic:/etc/nginx$ cat 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     REMOTE_ADDR             $remote_addr;
uwsgi_param     REMOTE_PORT             $remote_port;
uwsgi_param     SERVER_PORT             $server_port;
uwsgi_param     SERVER_NAME             $server_name;