mod_proxy_html不生效的典型表现是页面可代理访问但HTML内链接仍指向内网地址，因未启用xml2enc、headers模块，URL映射顺序错误，或后端返回gzip压缩/非UTF-8编码内容导致解析失败。
mod_proxy_html 不生效的典型表现
页面能正常代理访问，但所有 <a>、<img>、<script>、<link> 标签里的 href 或 src 仍指向原始内网地址（如 http://10.5.10.200/css/app.css），导致资源 404 或跳转到不可达地址。这不是 ProxyPassReverse 能解决的问题——它只改响应头和重定向 Location，不碰 HTML 内容体。
必须启用且按顺序加载的模块
mod_proxy_html 依赖 mod_proxy 和 mod_xml2enc，缺一不可。常见错误是只启用了 proxy_html 却漏掉 xml2enc，结果 Apache 启动失败或过滤静默失效：
a2enmod proxy proxy_http proxy_html xml2enc headers-
xml2enc用于解析 HTML 字符编码，尤其当后端返回Content-Type: text/html; charset=gb2312这类非 UTF-8 响应时，没它会直接跳过解析 -
headers模块必需，因为配置中常含RequestHeader unset Accept-Encoding——若缺失，apachectl configtest会报错退出
ProxyHTMLURLMap 的方向和顺序很关键
映射不是“替换字符串”，而是基于 URL 路径前缀的模式匹配，且按配置顺序执行。错误写法如 ProxyHTMLURLMap / /lab/ 放在 ProxyHTMLURLMap http://10.5.10.200 /lab 前面，会导致绝对 URL 先被误匹配成相对路径而损坏。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 先处理绝对 URL：
ProxyHTMLURLMap http://10.5.10.200 /lab（末尾无斜杠，避免把http://10.5.10.200/api错改成/lab/api） - 再处理相对 URL：
ProxyHTMLURLMap / /lab/（开头斜杠必须，否则匹配不到href="css/main.css"） - 如果后端用的是
https://，也要加一行：ProxyHTMLURLMap https://10.5.10.200 /lab - 所有
ProxyHTMLURLMap必须放在<Location>块内，或全局配置的对应<VirtualHost>下，不能丢在 .htaccess 里
容易被忽略的 Content-Encoding 和缓存干扰
后端若返回 Content-Encoding: gzip，mod_proxy_html 默认无法解压并重写压缩内容，直接跳过处理——页面链接原样保留。
立即学习“前端免费学习笔记（深入）”；
- 强制禁用后端压缩：
RequestHeader unset Accept-Encoding（配合headers模块） - 或让后端不压缩 HTML 响应（更稳妥），只压缩静态资源
- 如果用了
mod_cache，确保缓存策略不缓存未处理的原始 HTML；可加CacheIgnoreHeaders Set-Cookie避免缓存污染 -
ProxyHTMLBufSize默认 8192 字节，若页面含超长内联<script>，需调大，否则截断脚本导致解析失败
真正麻烦的点不在配置语法，而在 HTML 内容本身：JavaScript 动态拼接的 URL（如 location.href = 'http://' + ip + '/api'）完全绕过 mod_proxy_html；base 标签、data-* 属性里的 URL 也不会被重写。这类情况得靠后端改逻辑，或者上层加 JS 注入补丁。
