必须手动启用mod_proxy及其依赖模块（如slotmem_shm、lbmethod_byrequests、proxy_http、proxy_balancer），并确保加载顺序正确，否则ProxyPass等指令会报500错误或“Invalid command”；还需启用httpd-vhosts.conf、配置BalancerMember route与stickysession匹配、添加balancer-manager访问控制、验证语法并彻底重启Apache。
XAMPP自带的Apache默认不启用代理模块，直接写ProxyPass会报500错误或“Invalid command”——必须手动开启mod_proxy及相关子模块，且顺序和依赖不能错。
确认并启用必需的Apache代理模块
XAMPP（尤其是Windows版）的httpd.conf里，代理相关模块默认全被注释。只开mod_proxy.so不够，mod_proxy_http.so和mod_proxy_balancer.so也得显式加载，否则balancer://语法无法识别。
-
mod_slotmem_shm.so和mod_lbmethod_byrequests.so必须提前加载，否则balancer启动失败（Apache 2.4+要求） - 在
httpd.conf中搜索LoadModule，取消以下几行的注释（注意顺序）：LoadModule slotmem_shm_module modules/mod_slotmem_shm.so LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
- 别漏掉
Include conf/extra/httpd-vhosts.conf——XAMPP把虚拟主机配置抽离到这个文件，代理规则得放进去才生效
用balancer://定义集群并设置粘性Session
本地模拟负载均衡时，后端常是多个Tomcat或不同端口的HTTP服务（如localhost:8081、localhost:8082）。关键不是加几个BalancerMember，而是route参数和stickysession必须配对，否则登录态反复丢失。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
route值要与后端应用实际生成的JSESSIONID路由标识一致（例如Tomcat的jvmRoute配置） - 若后端没配
jvmRoute，就别设stickysession=JSESSIONID，否则所有请求都打到第一个节点 - 示例配置（放在
httpd-vhosts.conf里）：<VirtualHost *:80> ServerName localhost ProxyRequests Off <Proxy balancer://mycluster> BalancerMember http://localhost:8081 route=node1 BalancerMember http://localhost:8082 route=node2 ProxySet stickysession=ROUTEID </Proxy> ProxyPass /app balancer://mycluster/app ProxyPassReverse /app balancer://mycluster/app </VirtualHost> -
ProxyPreserveHost On建议加上，否则后端日志里看到的Host全是localhost，调试困难
访问/balancer-manager前必须放开访问控制
XAMPP默认禁止外部访问balancer-manager，连localhost都不放行——浏览器打开http://localhost/balancer-manager直接403。
- 在
httpd-vhosts.conf里追加位置块，注意Apache 2.4的权限语法已变：<Location "/balancer-manager"> SetHandler balancer-manager Require local </Location> - 如果用Chrome或远程机器访问，把
Require local换成Require ip 127.0.0.1 ::1更安全 - 配置改完必须运行
xampp/apache/bin/httpd.exe -t验证语法，再重启Apache服务——XAMPP控制面板点“Stop”再“Start”不等于重载，得彻底重启进程
本地hosts和路径匹配最容易出错
用XAMPP做反向代理测试时，90%的“404”或“连接被拒绝”不是代理配置问题，而是路径没对齐。
- 后端服务根路径是
http://localhost:8081/myapp/，但ProxyPass /myapp balancer://...里少了个/，就会变成/myappmyapp/拼接错误 - 浏览器访问
http://localhost/myapp，但ProxyPass写成/myapp/（结尾带斜杠），会导致重定向301跳转到http://localhost/myapp// - 如果想用域名如
test.local测试，必须改C:\Windows\System32\drivers\etc\hosts，加127.0.0.1 test.local，且VirtualHost的ServerName要严格匹配 - Windows下hosts文件保存需管理员权限，记事本右键“以管理员身份运行”再编辑，否则看似保存成功实则没写入
真正麻烦的从来不是写几行ProxyPass，而是每个route值、每个ProxyPass末尾斜杠、每次改完没跑-t验证就重启——这些细节卡住时，错误日志里往往只有一句proxy: No protocol handler was valid for the URL，根本看不出哪条配置挂了。
