Apache反向代理处理带#字符URL丢失后续内容的问题咨询

URL中的#及之后的内容属于锚点（hash fragment），按照HTTP标准规范，浏览器永远不会将这部分内容发送到服务器端，所以Apache收到请求时报文里本身就没有hash部分，并非Apache主动删除。如果后端规则中的#是实际路径的一部分，默认会被编码为%23传递，Apache默认的URL标准化逻辑会将其解码后丢弃。

方案1：路径#编码场景（最简便） #

如果后端URL中的#是路径组成部分，仅需修改Apache虚拟主机配置即可：

• 启用必要模块：

a2enmod proxy proxy_http

• 调整代理配置：

# 允许编码后的特殊字符不被自动解码
AllowEncodedSlashes NoDecode
# 新增nocanon参数，直接传递原始请求URL给后端，不做标准化处理
ProxyPass / http://你的后端服务地址/ nocanon
ProxyPassReverse / http://你的后端服务地址/

• 重启Apache生效：

systemctl restart apache2

方案2：单页应用（SPA）hash路由场景 #

如果后端是使用hash路由的单页应用，只需要将所有非静态资源的请求全部转发到SPA入口文件，浏览器会自动保留hash部分完成前端路由：

RewriteEngine On
# 静态资源直接返回
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 其他请求全部转发到入口文件
RewriteRule ^(.*)$ /index.html [L]

ProxyPass / http://你的后端服务地址/
ProxyPassReverse / http://你的后端服务地址/

方案3：通用全场景适配 #

如果不属于上述两种场景，可以通过Apache注入前端脚本自动捕获锚点转义传递，全程后端无感知：

• 启用必要模块：

a2enmod rewrite substitute proxy proxy_http headers

• 添加配置：

AllowEncodedSlashes NoDecode
RewriteEngine On
# 捕获转义传递的hash参数，内部还原为原始路径
RewriteCond %{QUERY_STRING} ^_proxy_hash=(.*)$
RewriteRule ^(.*)$ $1#%1 [NE,R=PERMANENT,L]

# 向返回的HTML中注入hash捕获脚本
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|</head>|<script>if(location.hash){location.replace(location.pathname + '?_proxy_hash=' + encodeURIComponent(location.hash.slice(1)));}</script></head>|i"

ProxyPass / http://你的后端服务地址/ nocanon
ProxyPassReverse / http://你的后端服务地址/

• 重启Apache生效。

内容的提问来源于stack exchange，提问作者Gabriele