服务器配置篇 ━━ IIS7使用https上传发生413错误，响应提示：未显示页面,因为请求实体过大

使用windows自建证书搭建网站，本地127.0.0.1上传正常，但外网上传仅限几十K的文件，若超出大小则提示：
错误：413；响应：“未显示页面,因为请求实体过大。”

一度以为是防火墙的问题，排查未果。今终于解决问题，整理如下：

一、原理

官方说明：Client cannot renegotiate request and returns an HTTP 413 error

• 如果 Web 服务器、网站或站点的单个目录或文件上启用了客户端证书，则客户端在上载较大的文件时可能会看到 HTTP 413 错误。

• 如果客户端向运行 IIS 6.0（7.0） 的 Web 服务器发送一个较长的 HTTP 请求（如 POST 请求），则 IIS 工作进程可能会收到足以解析请求标头的数据，但不会收到整个请求实体正文。当 IIS 工作进程检测到需要客户端证书以向客户端返回数据时，IIS 尝试重新协商客户端连接。不过，客户端无法重新协商连接，因为它正在等待向 IIS 发送请求中的其余数据。

• 如果请求客户端重新协商，则必须使用 SSL 预加载功能预加载请求实体正文。SSL 预加载功能将使用用于 ISAPI 扩展的 UploadReadAheadSize 配置数据库属性的值。但是，如果 UploadReadAheadSize 小于内容长度，则返回 HTTP 413 错误，并关闭连接以防止出现死锁。（在以下情况下出现“死锁”：客户端正在等待发送请求实体，而服务器等待完成重新协商，重新协商要求客户端能够发送数据，可是这是无法完成的。）

• 解决方案是确保没有禁止客户端发送整个实体正文。为此，应将 UploadReadAheadSize 的值更改为大于内容长度的值和最大请求实体主体限制更改为大于文件大小。

二、解决方案

1. 配置UploadReadAheadSize 【关键】

官方解决方案：IIS7 Tweet #1 : Setting UploadReadAheadSize

• 使用 Appcmd.exe 命令来修改限制，Appcmd.exe 位于 %WinDir%\System32\Inetsrv

appcmd.exe set config  -section:system.webServer/serverRuntime /uploadReadAheadSize:"49152"  /commit:apphost

• 把 uploadReadAheadSize 的值逐渐改大来做测试，比如可以98304 -> 196608 -> 393216 -> 20480000。
  

2. 配置MaxRequestEntityAllowed

• 在IIS 功能视图 中双击 ASP 模块，打开 限制属性 ，将最后一项 最大请求实体主体限制[maxRequestEntityAllowed] 改为你需要的值(例如 1073741824, 1GB)。
• 同时，请注意如果你上传的文件较大，请考虑 脚本超时[scriptTimeOut] 是否需要更改， 默认是00:01：30，可改成了00:05:30。

3.修改开发语言自身的限制

比如php，在php.ini中重新配置上传限制，因与本文关系不大，各种开发语言的上传限制不再赘述。

max_execution_time = 300
max_input_time = 600
post_max_size = 8M
upload_max_filesize = 50M
max_file_uploads = 20

4.配置maxAllowedContentLength

项目主目录web.config文件，参考以下内容，增加maxAllowedContentLength

<?xml version="1.0" encoding="UTF-8"?>
    <configuration>
        <system.webServer>
            <security>
                <requestFiltering>
                    <requestLimits maxAllowedContentLength="1048576000" />
                </requestFiltering>
            </security>
            <handlers>
                <add name="Python FastCGI" path="*" verb="*" modules="FastCgiModule" scriptProcessor="C:\Users\Administrator\.virtualenvs\Python-LxgTLIVq\Scripts\python.exe|E:\Python\wfastcgi.py" resourceType="Unspecified" requireAccess="Script" />
            </handlers>
        </system.webServer>
        <appSettings>
            <add key="WSGI_HANDLER" value="django.core.wsgi.get_wsgi_application()" />
            <add key="PYTHONPATH" value="E:\Python" />
            <add key="DJANGO_SETTINGS_MODULE" value="workjob.settings" />
        </appSettings>
    </configuration>

maxAllowedContentLength=“1048576000” ，将最大允许内容长度配置为1000M。

5. 上传超时

大文件上传时间可能超过既定值，导致报错：“HTTP 错误 500.0 - Internal Server Error”FastCGI 进程超过了配置的请求超时时限。

参考以下修改时间

重启IIS

三、参考

1. 安全篇 ━━ windows2008自建证书、IIS配置https服务器及浏览器报错处理
2. 关于如何设置IIS7的配置，请参考 Configuration Reference <configuration>
3. IIS7 https 发生413错误 未显示页面,因为请求实体过大
4. Django + iis 上传文件时发生未显示页面,因为请求实体过大
5. 小程序上传附件问题：未显示页面，因为请求实体过大
6. 前端大文件上传方法(深度好文)