nginx 關於client_max_body_size client_body_buffer_size配置

最近生產環境在這兩個參數之間遇到過幾次坑。這裏記錄下。

client_max_body_size

client_max_body_size 默認 1M，表示 客戶端請求服務器最大允許大小，在“Content-Length”請求頭中指定。如果請求的正文數據大於client_max_body_size，HTTP協議會報錯 413 Request Entity Too Large。就是說如果請求的正文大於client_max_body_size，一定是失敗的。如果需要上傳大文件，一定要修改該值。

client_body_buffer_size

Nginx分配給請求數據的Buffer大小，如果請求的數據小於client_body_buffer_size直接將數據先在內存中存儲。如果請求的值大於client_body_buffer_size小於client_max_body_size，就會將數據先存儲到臨時文件中，在哪個臨時文件中呢？
client_body_temp 指定的路徑中，默認該路徑值是/tmp/.
所以配置的client_body_temp地址，一定讓執行的Nginx的用戶組有讀寫權限。否則，當傳輸的數據大於client_body_buffer_size，寫進臨時文件失敗會報錯。
這個問題我們遇到過。

20648 open() "/usr/local/openresty-1.9.7.5/nginx/client_body_temp/0000000019" failed (13: Permission denied)

/usr/local/openresty-1.9.7.5/nginx/client_body_temp/這個文件夾權限改爲執行Nginx的用戶羣組就可以解決。
在這個問題上和語言就相關了，如果使用的是PHP，PHP會自己將臨時文件讀取出來，放置到請求數據裏面，這是沒有問題的，開發者也不需要關心。肯定是完整的數據。
如果使用的openresty lua 開發的話，就需要開發者自己讀取出來，讓後續的邏輯使用。

                function getFile(file_name)
                    local f = assert(io.open(file_name, 'r'))
                    local string = f:read("*all")
                    f:close()
                    return string
                end

                ngx.req.read_body()
                local data = ngx.req.get_body_data()
                if nil == data then
                    local file_name = ngx.req.get_body_file()
                    ngx.say(">> temp file: ", file_name)
                    if file_name then
                        data = getFile(file_name)
                    end
                end

                ngx.say("hello ", data)

總結

傳輸的數據大於client_max_body_size，一定是傳不成功的。小於client_body_buffer_size直接在內存中高效存儲。如果大於client_body_buffer_size小於client_max_body_size會存儲臨時文件，臨時文件一定要有權限。
如果追求效率，就設置 client_max_body_size client_body_buffer_size相同的值，這樣就不會存儲臨時文件，直接存儲在內存了。