XAMPP 默认拒绝 Expect: 100-continue 请求并返回417错误，因 mod_headers 未启用且无 Expect 处理规则；需在 httpd.conf 中启用 mod_headers 模块，并在每个相关 VirtualHost 中添加 RequestHeader unset Expect。
XAMPP 默认不启用 Expect 请求头处理，即使配好多端口，Expect: 100-continue 也会被 Apache 直接拒绝（返回 417 错误）——这不是端口配置问题，而是模块与响应策略未开启。
为什么多端口配置后仍遇到 417 Expectation Failed
Apache 在收到带 Expect: 100-continue 的请求时，默认行为是直接返回 417 Expectation Failed，除非显式启用 mod_headers 并配置响应逻辑。这和监听多少端口无关，哪怕只用 :80 也会触发该错误。
- 常见触发场景：PHP cURL 发起大文件上传、Postman 手动加
Expect头、某些 HTTP 客户端库（如 Guzzle）默认携带 - 错误现象：
curl: (22) The requested URL returned error: 417或浏览器控制台显示417 Expectation Failed - 关键点：XAMPP 自带的 Apache 编译时已包含
mod_headers，但默认未加载，也未配置任何Expect相关响应规则
启用 Expect 处理必须做的两件事
仅修改 httpd.conf 中的 Listen 和 httpd-vhosts.conf 中的 <virtualhost></virtualhost> 不解决 417 问题。必须补全以下操作：
XAMPP 8.0.30
下载
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
- 确认
mod_headers已启用：打开C:\XAMPP\apache\conf\httpd.conf，取消注释这一行：LoadModule headers_module modules/mod_headers.so - 在对应虚拟主机或全局配置中添加响应头处理规则，例如在
<virtualhost></virtualhost>内部加入：<If "%{HTTP:Expect} == '100-continue' "> Header always set Expect "100-continue" </If>（注意：这只是示例写法；实际更稳妥的做法是禁用客户端的Expect行为，见下一条） - 更推荐方案：让 Apache 主动忽略
Expect头，避免协商流程——在虚拟主机内加一行：RequestHeader unset Expect
多端口 + Expect 共存时最容易踩的坑
多个 <virtualhost></virtualhost> 共享同一份模块加载状态，但 RequestHeader 指令作用域受限于所在块。容易遗漏导致部分端口仍报 417：
- 每个需支持上传的端口（如
*:8080、*:8081）都必须单独写RequestHeader unset Expect，不能只写在*:80下 - 如果使用了
<directory></directory>块嵌套，RequestHeader必须放在<virtualhost></virtualhost>级别，否则不生效 - Windows 下路径含空格或中文时，
httpd -t语法检查会失败，导致 Apache 启动不了——先运行httpd -t再重启服务 -
RequestHeader unset Expect不影响其他请求头，也不会降低安全性，只是跳过 HTTP/1.1 的 100-continue 协商步骤，对绝大多数开发场景无副作用
真正要花时间调试的，从来不是“怎么加端口”，而是“为什么加了端口还卡在 417”。模块是否加载、指令是否落在正确作用域、有没有漏掉某个端口的配置——这些细节不验证，重启十次 Apache 都没用。
