如何设置XAMPP中Apache代理将请求转发至Tomcat服务器？

本文共计831个文字，预计阅读时间需要4分钟。

由于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"/>
• 确保它没被注释，且 port 值和 Apache 的 ProxyPass 地址一致（如 ajp://localhost:8009/）

如果 Tomcat 启动后控制台报 SEVERE: Failed to initialize end point associated with ProtocolHandler ["ajp-apr-8009"]，大概率是端口被占用（比如另一个 Tomcat 或 Skype），换端口或杀掉冲突进程即可。

代理规则写在哪？怎么避免路径和 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 不报错，只默默返回空白页。