nginx 通过 msie_padding 和 msie_refresh 指令应对 ie5.5–ie6 的 http 协议层缺陷:前者自动追加最多 128 字节空格防响应截断,后者添加 refresh 头提升重定向兼容性;需规避 chunked_transfer_encoding 冲突、content-length 剥离等陷阱,并优先考虑应用层修复。

Nginx 的 http 块中配置老旧浏览器兼容,核心不是“修复页面样式”,而是应对 IE5.5–IE6 等极老客户端在 HTTP 协议层的解析缺陷。这类浏览器对短响应体、缺失头字段、分块传输等行为处理异常,容易触发截断、空白页或连接中断。关键指令是 msie_padding 和配套机制,而非泛泛的“兼容开关”。
msie_padding:专治 IE5.5–IE6 的响应截断问题
该指令只对 User-Agent 匹配 MSIE [5-6]\. 的请求生效,且仅作用于非 chunked、非流式响应(如静态文件、FastCGI 返回的空/短响应)。它会在响应体末尾自动追加最多 128 字节空格,使响应体变长,从而绕过 IE 对极短响应(如 0 字节、3 字节)的错误截断逻辑。
- 默认已开启,无需额外写
msie_padding on; - 如需关闭(例如确认无 IE6 用户且想省点带宽),在
http块中写:msie_padding off;
- 它不接受数字参数,不能设长度或字符;也不能用在
if或动态上下文中
配合 msie_refresh 改善重定向体验
IE5.5–IE6 对 301/302 重定向响应中的 Refresh 头支持更稳定,而标准 Location 头有时被忽略。启用后,Nginx 会对匹配的老 IE 自动添加 Refresh: 0; url=... 头(与 Location 并存):
msie_refresh on;
这对登录跳转、表单提交后重定向类场景很实用,建议与 msie_padding 同时启用。
必须规避的配置陷阱
- 不要和
chunked_transfer_encoding off;混用:老 IE 本身不支持 chunked,若后端返回 chunked 响应而 Nginx 又强行关掉编码,可能导致响应混乱 - 确保
Content-Length头未被 CDN 或前置代理剥离:msie_padding依赖准确的响应长度计算,若头被改写,padding 可能失效或引发长度不一致 - 若使用
proxy_pass,后端响应体需足够短(通常 Content-Length
更推荐的替代思路(优先级高于 Nginx 层补丁)
- 在应用层对关键短响应显式设置
Content-Length: 0,或返回带内容的轻量体(如{"ok":true}),从源头避免“超短响应” - 用
map指令识别老 UA 并注入自定义 header(如X-Old-IE: 1),便于后端做差异化逻辑,比被动加 padding 更可控 - 现代系统中,建议在
server块而非全局http块启用这些指令,避免影响其他不需要兼容的站点
不复杂但容易忽略。











