一、URL重写技术概述

URL重写（URL Rewriting）是现代Web开发中至关重要的基础设施技术，其核心价值在于通过转换URL结构实现三大目标：提升安全性（隐藏真实路径）、优化用户体验（增强可读性）以及改善搜索引擎索引效果（SEO友好）。该技术通过服务器端过滤器拦截请求，基于预定义规则对URL进行动态转换，最终向客户端返回重写后的地址。

典型应用场景包括：

将动态参数化URL（如/user?id=123）转换为静态形式（如/user/123）
实现多域名/多协议的统一入口处理
隐藏敏感路径信息（如将/admin/login转换为/secure/entry）
支持旧系统URL的兼容性跳转

技术实现层面，主流方案采用基于Servlet过滤器的架构，通过正则表达式匹配请求路径，结合规则引擎执行重定向或内部转发操作。相较于Nginx层的URL重写，应用层实现具有更灵活的动态规则处理能力，尤其适合需要结合业务逻辑的复杂场景。

二、核心原理与工作机制

1. 过滤器链处理流程

URL重写技术的实现依赖于Servlet容器中的过滤器链机制，其标准处理流程包含三个关键阶段：

请求拦截阶段：过滤器捕获所有进入容器的HTTP请求
规则匹配阶段：通过正则表达式引擎解析请求URI
重写执行阶段：根据匹配结果执行重定向（301/302）或内部转发

// 伪代码示例：过滤器核心逻辑
public class UrlRewriteFilter implements Filter {
    private RuleEngine engine;
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        String originalUri = httpRequest.getRequestURI();
        // 规则匹配与重写
        RewriteResult result = engine.match(originalUri);
        if (result.isRedirect()) {
            ((HttpServletResponse)response).sendRedirect(result.getNewUrl());
        } else {
            chain.doFilter(new RewrittenRequestWrapper(request, result.getNewUri()), response);
        }
    }
}

2. 正则表达式规则设计

规则文件通常采用XML格式定义，每个<rule>节点包含匹配模式（from）和重写目标（to），支持正则捕获组和条件判断：

<rule>
    <from>^/product/(\d+)$</from>
    <to type="forward">/productDetail.jsp?id=$1</to>
</rule>
<rule>
    <from>^/old-page$</from>
    <to type="redirect">/new-page</to>
</rule>

高级特性包括：

条件判断：基于请求头、Cookie等上下文信息决定是否重写
动态参数：支持%{time}等服务器变量插入
优先级控制：通过<rule>顺序或priority属性定义匹配顺序

3. 双向重写机制

除入站重写（Inbound Rewrite）外，系统还需处理出站重写（Outbound Rewrite），确保生成的链接也符合重写规则：

<outbound-rule>
    <from>^/productDetail\.jsp\?id=(\d+)$</from>
    <to>/product/$1</to>
</outbound-rule>

该机制通过字节码增强或标签库实现，要求开发者使用服务器端标签（如JSTL的<c:url>）而非硬编码HTML链接。

三、工程化实现指南

1. 环境准备与依赖管理

推荐采用Maven管理依赖，核心库包含：

<dependency>
    <groupId>org.tuckey</groupId>
    <artifactId>urlrewritefilter</artifactId>
    <version>4.0.4</version>
</dependency>

2. 配置文件规范

规则文件urlrewrite.xml必须放置在WEB-INF目录下，采用UTF-8编码。标准结构示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE urlrewrite PUBLIC "-//tuckey.org//DTD UrlRewrite 4.0//EN"
    "http://www.tuckey.org/res/dtds/urlrewrite4.0.dtd">
<urlrewrite>
    <!-- 全局规则 -->
    <rule>
        <note>隐藏真实路径</note>
        <from>^/secure/admin$</from>
        <to type="forward">/admin/dashboard.jsp</to>
    </rule>
    <!-- 出站规则 -->
    <outbound-rule>
        <from>^/api/v1/(\w+)$</from>
        <to>/$1-api</to>
    </outbound-rule>
</urlrewrite>

3. web.xml集成配置

需在过滤器配置中指定规则文件路径和初始化参数：

<filter>
    <filter-name>UrlRewriteFilter</filter-name>
    <filter-class>org.tuckey.web.filters.urlrewrite.UrlRewriteFilter</filter-class>
    <init-param>
        <param-name>logLevel</param-name>
        <param-value>WARN</param-value>
    </init-param>
    <init-param>
        <param-name>confPath</param-name>
        <param-value>/WEB-INF/urlrewrite.xml</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>UrlRewriteFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

4. 服务器端变量嵌入规范

为确保出站重写生效，所有动态链接必须通过服务器端标签生成：

<!-- 正确方式 -->
<a href="<c:url value='/product/123'/>">商品详情</a>
<!-- 错误方式（无法重写） -->
<a href="/product/123">商品详情</a>

四、性能优化与最佳实践

1. 规则设计原则

最小匹配原则：将高频访问规则放在配置文件顶部
避免过度重写：每个请求最多执行1次重定向
正则表达式优化：使用非捕获组(?:...)减少回溯

2. 调试技巧

启用DEBUG日志级别记录重写过程
使用<rule>的<set type="status">404</set>测试规则匹配
通过<run/>集成自定义规则处理器

3. 安全注意事项

对用户输入的路径参数进行严格校验
防止开放重定向漏洞（Open Redirect）
定期审计重写规则防止路径遍历攻击

五、常见问题解决方案

1. 规则不生效排查

检查urlrewrite.xml是否在WEB-INF目录
验证XML格式是否正确（DTD校验）
确认过滤器在web.xml中正确映射
检查日志中是否有规则加载错误

2. 性能瓶颈优化

对静态资源排除重写过滤
使用<rule>的<condition>减少不必要的匹配
考虑缓存重写结果（需权衡实时性要求）

3. 与CDN/缓存系统集成

在CDN层配置忽略查询参数的缓存策略
对重写后的URL设置合理的Cache-Control头
使用版本号或哈希值实现静态资源缓存刷新

通过系统掌握上述技术要点，开发者能够构建出安全、高效且易于维护的URL重写系统，为Web应用提供坚实的基础架构支持。实际工程中建议结合自动化测试工具（如JMeter）验证重写规则的正确性，并通过监控系统持续跟踪重写性能指标。

URL重写技术深度解析：从原理到工程化实践