XAMPP 中 Apache 与 Tomcat 是独立进程，默认不通信；Apache 不识别 WAR、JSP 或 Servlet，直接访问会 404 或下载 WAR 文件。需启用 mod_proxy、mod_proxy_ajp 等模块，配置 AJP 代理（如 ProxyPass /myapp ajp://localhost:8009/myapp），并确保 Tomcat 的 AJP Connector 开启且端口一致，最后重启两个服务。
为什么直接把 WAR 放进 htdocs 会失败
因为 XAMPP 的 Apache 和 Tomcat 是两个独立进程，默认完全不通信。Apache 根本不识别 .war、.jsp 或 servlet，它只会把 myapp.war 当作普通二进制文件返回（浏览器直接下载），或者返回 404 —— 它压根没把请求转给 Tomcat。
常见错误现象包括：
- 访问
http://localhost/myapp/→ 404 或下载myapp.war - 改了
httpd.conf但没启用对应模块 → 启动 Apache 失败，日志里报Invalid command 'ProxyPass' - 用了
ProxyPass / http://localhost:8080/却丢 session → 没加ProxyPassReverseCookiePath，JSESSIONID 路径错乱
必须启用的 Apache 模块有哪些
不是所有 XAMPP 版本都默认启用代理模块。你得手动确认并放开注释（Windows 下路径为 xampp\apache\conf\httpd.conf）：
LoadModule proxy_module modules/mod_proxy.so-
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so（推荐 AJP，比 HTTP 代理更稳） -
LoadModule proxy_http_module modules/mod_proxy_http.so（仅用 HTTP 代理时才需要）
注意：mod_proxy_balancer 和 mod_slotmem_shm 不是必需项，除非你要做 Tomcat 集群负载均衡。单机部署别加，反而容易因依赖缺失导致 Apache 启动失败。
用 AJP 代理时 Tomcat 的 connector 必须开启
AJP 协议靠 Tomcat 的 AJP Connector 工作，默认是开的，但必须确认：
- 打开
xampp\tomcat\conf\server.xml - 找到类似这行（通常在第 80 行左右）：
<connector port="8009" protocol="AJP/1.3" redirectport="8443"></connector> - 确保它没被注释，且
port值和 Apache 的ProxyPass地址一致（如ajp://localhost:8009/）
如果 Tomcat 启动后控制台报 SEVERE: Failed to initialize end point associated with ProtocolHandler ["ajp-apr-8009"]，大概率是端口被占用（比如另一个 Tomcat 或 Skype），换端口或杀掉冲突进程即可。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
代理规则写在哪？怎么避免路径和 Cookie 错乱
不要直接往 httpd.conf 末尾硬塞 ProxyPass —— XAMPP 推荐用 httpd-ajp.conf（位于 xampp\apache\conf\extra\），再通过 Include conf/extra/httpd-ajp.conf 引入主配置。
一个最小可用的 AJP 代理配置示例（假设项目叫 myapp）：
ProxyPreserveHost On ProxyRequests Off ProxyPass /myapp ajp://localhost:8009/myapp smax=0 ttl=60 retry=5 ProxyPassReverse /myapp ajp://localhost:8009/myapp ProxyPassReverseCookiePath /myapp /myapp
关键点：
-
ProxyPreserveHost On：让 Tomcat 日志里记录的是原始 Host（如t1.m.com），不是localhost:8009 -
smx=0 ttl=60 retry=5：防止连接中断后 Apache 一直缓存失败状态 -
ProxyPassReverseCookiePath必须显式设置，否则 JSESSIONID 写到根路径/，跨子路径会失效
改完配置后，**必须重启 Apache 和 Tomcat 两个服务** —— 只重启 Apache，Tomcat 还在用旧 connector；只重启 Tomcat，Apache 不加载新规则。
最常被忽略的是：AJP 代理下，webapps/ 里的项目名必须和 ProxyPass 路径严格一致（大小写、有无 trailing slash），否则 Tomcat 找不到 Context，404 不报错，只默默返回空白页。
