checkspelling是apache mod_speling模块提供的url拼写纠错功能，多端口下易失效因其仅在各块内单独启用才生效，未逐端口配置则对应端口不触发纠错。
CheckSpelling 在 XAMPP 的 Apache 多端口配置中默认不生效，且不能靠简单开启就跨端口/跨虚拟主机统一启用——它只对当前 <virtualhost></virtualhost> 块内、且满足路径匹配条件的请求起作用。
CheckSpelling 是什么，为什么多端口下容易失效
CheckSpelling 是 Apache 的 mod_speling 模块提供的功能，用于自动纠正大小写错误或拼写近似的 URL（比如访问 /about-us.html 但实际文件是 /About-US.html）。但它不是全局开关：必须在每个 <virtualhost></virtualhost>、<virtualhost></virtualhost> 等块里单独启用，否则该端口下的请求完全忽略它。
常见误操作是只在 httpd.conf 顶层启用模块，却没在各 <virtualhost></virtualhost> 中显式设置 CheckSpelling on，结果只有默认端口（如 80）生效，其他端口 404 且无纠错提示。
如何在每个端口的 VirtualHost 中启用 CheckSpelling
确保以下三点同时满足：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 模块已加载：
LoadModule speling_module modules/mod_speling.so在httpd.conf中未被注释（XAMPP 默认已启用） - 每个目标
<virtualhost></virtualhost>块内明确写入：CheckSpelling on - 对应目录允许覆盖：
<directory> AllowOverride All </directory>（否则.htaccess中的CheckSpelling on不会读取）
示例（httpd-vhosts.conf 片段）：
<virtualhost>
DocumentRoot "D:/xampp/htdocs/project-a"
ServerName localhost:8080
CheckSpelling on
<directory>
Options FollowSymLinks
AllowOverride All
Require all granted
</directory></virtualhost><p><virtualhost>
DocumentRoot "D:/xampp/htdocs/project-b"
ServerName localhost:8081
CheckSpelling on <!-- 这行不能少！-->
<directory>
Options FollowSymLinks
AllowOverride All
Require all granted
</directory></virtualhost></p>
CheckSpelling 的典型坑和限制
即使配置正确，这些情况会让它“看似不工作”：
- 请求路径是目录（如
/admin/），但目录下没有index.*文件且Options Indexes关闭 → 直接 403/404，不触发拼写检查 - 文件名差异过大（如
contct.htmlvscontact.html）→ Apache 默认只接受编辑距离 ≤1 的候选，需配合SpelingForceRedirect on或自定义规则 - URL 含查询参数（
?id=123）→CheckSpelling只检查路径部分，参数不影响匹配，但重定向后可能丢失参数 - Windows 文件系统默认不区分大小写 → 若真实文件是
Page.HTML，访问/page.html本就能命中，无需纠错；只有启用了EnableSendfile off或混用大小写敏感存储时才明显
验证是否真正生效的最快方式
不用重启 Apache，用命令行快速语法检测 + 实际测试：
- 运行
httpd -t（在 XAMPP 控制面板点击 “Shell” 后执行），确认配置无语法错误 - 在对应项目目录下放两个文件：
Test.php和test.php（内容不同），然后访问http://localhost:8080/test.php→ 应返回test.php；再访问http://localhost:8080/Test.php→ 若返回Test.php，说明没纠错；若自动跳转或返回test.php，说明CheckSpelling生效 - 查看 Apache 错误日志（
xampp\apache\logs\error.log），搜索speling，有类似[speling:notice]行即表示模块正在参与处理
多端口场景下，CheckSpelling 不是“配一次全端口通用”的功能，而是每个端口的虚拟主机都得单独声明、单独授权、单独测试。漏掉任何一个 <virtualhost></virtualhost> 块里的 CheckSpelling on，那个端口就等于没开。
