Flask uwsgi nginx:504 Gateway Time out

uwsgi+nginx部署的web站点运行时可能产生504 Gateway Time out这样的错误，究其原因是因为相关参数设置的不当。

nginx和uwsgi整合时有三个参数可以用于设置超时时间，在nginx配置文件http->server->location中设置。

uwsgi_connect_timeout：默认60秒，与uwsgi-server连接的超时时间，该值不能超过75秒.若在超时时间内未能成功连接则断开连接尝试。
uwsgi_read_timeout：默认60秒，nginx等待uwsgi进程发送响应数据的超时时间。若有需要长时间运行才能产生输出结果的uwsgi进程则需将此参数调高。若在错误日志文件中看到 upstream timed out需将此参数调高。若超过超时时间还未收到响应则nginx关闭连接。
uwsgi_send_timeout：默认60秒，nginx向uwsgi进程发送请求的超时时间。超时时间由两次写操作的时间间隔算，而非整个请求。若超过超时时间仍没写入动作则nginx关闭连接。

另外uwsgi自身还有一个参数harakiri(在uwsgi.xml或uwsgi.ini中配置)，若每次请求需要花费超过该值的时间则放弃该请求处理相应的worker被收回.

Nginx下Uwsgi模块常用参数说明 

Nginx下的Uwsgi

官方文档

实际配置(/etc/nginx/nginx.conf)

该例中,只用到3个参数

server {
        listen   5000;
        server_name localhost; if ( $request_method !~ ^(GET|HEAD|POST)$ ) { return 403;
        }

        location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:3031;
        uwsgi_read_timeout 180;
        }
}

(部分)参数说明

uwsgi_bind

default: none
绑定一个ip地址,uwsgi通过该绑定的地址与外界通信.

uwsgi_buffer_size

default: uwsgi_buffer_size 4k/8k
读缓冲的大小,默认情况下,等同于uwsgi_buffers,不过它可以设置的更小.

uwsgi_buffering

default: uwsgi_buffering on
响应缓冲

uwsgi_buffers

default: uwsgi_buffers 8 4k/8k
设置读缓冲区的数量和大小,默认是8个,4k, 用于缓存从uwsgi服务的应答.

uwsgi_cache

default: off
共享缓存

uwsgi_connect_timeout

default: uwsgi_connect_timeout 60
连接uWSGI-Server的超时时间,不能超过75秒

uwsgi_ignore_client_abort

default: uwsgi_ignore_client_abort off
忽略uWSGI-Server返回的终止响应.

uwsgi_modifier1

default: 0
为uwsgi请求设置第一个修饰符,默认是WSGI请求.(??)

uwsgi_modifier2

default: 0

uwsgi_param

default: none
指定uWSGI-server, 参数可以是字符串,变量,或者它们的组合.

uwsgi_pass

default: none
指定uWSGI-server的IP地址和端口,或者socket文件
或者定义负载均衡器

upstream backend  {
  server 192.168.0.1:3031;
  server 192.168.0.2:3031;
}
 
uwsgi_pass   backend;

uwsgi_read_timeout

default: uwsgi_read_timeout 60
设置一个等待uwsgi返回数据的超时时间.

uwsgi_send_timeout

default: uwsgi_send_timeout 60
设置一个向uwsgi发动请求的超时时间