在现代微服务架构中，后端API的迭代升级是一个持续的过程。为了保证旧版客户端的兼容性，系统通常会同时运行多个版本的RESTful API。利用Apache HTTP Server作为反向代理服务器，在流量入口处直接进行版本路由分发，是一种高效且对业务代码零侵入的解决方案。通过合理的配置，Apache能够根据请求URL中的版本号标识，将请求精准代理到不同的后端服务节点。
为什么需要在Apache层实现API版本路由？
当业务需求发生重大变更时，我们往往需要发布新版本的API（例如v2），同时保留旧版本API（v1）继续运行一段时间。如果将版本路由的逻辑写在业务代码中，会导致代码库变得臃肿，且每次版本迭代都需要修改核心路由模块，增加了出错的风险。将版本路由的职责上移到网关层或反向代理层，可以让后端服务专注于业务逻辑本身，实现职责的单一性。
Apache HTTP Server凭借其出色的稳定性和丰富的模块生态，非常适合承担这一角色。通过加载mod_proxy模块及其子模块，Apache可以轻松化身为反向代理服务器。相比于在Nginx或代码层做路由，很多历史悠久的系统已经深度依赖Apache，直接利用现有的Apache服务器进行API版本路由配置，不仅能省去引入新组件的运维成本，还能充分利用现有的安全与日志配置。
在Apache层实现版本路由的核心思路，是解析客户端请求的URL路径。RESTful API通常在路径中携带版本号，例如/api/v1/users和/api/v2/users。Apache通过识别v1和v2这两个关键字，将请求分别转发到不同的后端地址。这种机制不仅支持灰度发布，还能在旧版本下线时，仅需修改一行配置即可完成流量切换。
基于mod_proxy与mod_rewrite的基础配置
要实现RESTful API的版本路由，首先需要确保Apache加载了必要的模块。除了核心的mod_proxy之外，还需要用到mod_proxy_http来处理HTTP协议的代理，以及mod_rewrite来进行复杂的URL匹配和重写。在配置文件中，可以通过LoadModule指令来加载它们。加载完成后，我们需要开启代理引擎，即设置ProxyRequests Off，这告诉Apache我们正在配置反向代理而非正向代理。
对于简单的版本路由场景，直接使用ProxyPass和ProxyPassReverse指令即可完成配置。假设我们有两个后端服务，v1版本运行在http://127.0.0.1:8081，v2版本运行在http://127.0.0.1:8082。我们可以编写如下的配置代码，将不同版本的API请求代理到对应的端口。这种配置方式简单直观，易于维护。
ProxyRequests Off # 代理v1版本API ProxyPass /api/v1/ http://127.0.0.1:8081/api/v1/ ProxyPassReverse /api/v1/ http://127.0.0.1:8081/api/v1/ # 代理v2版本API ProxyPass /api/v2/ http://127.0.0.1:8082/api/v2/ ProxyPassReverse /api/v2/ http://127.0.0.1:8082/api/v2/
在上述配置中，ProxyPass指令将匹配到的路径前缀映射到后端服务器地址。需要注意的是，路径末尾的斜杠非常重要，它决定了路径拼接的行为。如果配置为ProxyPass /api/v1/ http://127.0.0.1:8081/，那么当请求/api/v1/users时，转发到后端的路径会变成/users，这取决于后端服务的上下文路径配置。同时，ProxyPassReverse指令用于修改后端响应中的Location头信息，防止客户端在遇到重定向时绕过代理直接访问后端。
复杂场景下的路由规则优化与避坑指南
在实际生产环境中，API的版本管理往往更加复杂。例如，有些旧版客户端可能没有在URL中携带版本号，默认应该路由到v1版本；或者我们需要根据请求的HTTP方法进行更细粒度的路由。这时，仅靠ProxyPass就不够了，必须结合mod_rewrite模块的强大正则匹配能力。通过RewriteRule配合[P]标志，我们可以实现更灵活的代理逻辑。
RewriteEngine On # 如果请求路径中没有版本号，默认重写到v1版本并代理 RewriteRule ^/api/(?!v[0-9]+/)(.*)$ /api/v1/$1 [L] # 将v1版本的请求代理到后端服务器 RewriteRule ^/api/v1/(.*)$ http://127.0.0.1:8081/api/v1/$1 [P,L] # 将v2版本的请求代理到后端服务器 RewriteRule ^/api/v2/(.*)$ http://127.0.0.1:8082/api/v2/$1 [P,L] # 必须配置ProxyPassReverse来处理重定向响应 ProxyPassReverse /api/v1/ http://127.0.0.1:8081/api/v1/ ProxyPassReverse /api/v2/ http://127.0.0.1:8082/api/v2/
上述配置中，我们使用了正则表达式的负向先行断言(?!v[0-9]+/)来识别没有版本号的请求，并将其内部重写到v1路径。然后，通过带有[P]标志的RewriteRule将请求代理到后端。使用[P]标志时，必须确保已经加载了mod_proxy模块，否则Apache会报错。此外，即使使用了RewriteRule进行代理，依然需要配置ProxyPassReverse来确保后端重定向响应的正确性，这是一个常见的配置遗漏点。
另一个需要注意的避坑点是关于反斜杠和路径拼接的问题。在Windows系统下配置Apache时，如果涉及到文件路径或者特定的正则转义，反斜杠必须原样保留，例如C:\Apache\conf\。而在URL重写规则中，反斜杠常用于转义特殊字符。此外，复杂的正则匹配会消耗较多的CPU资源，在高并发的API网关场景下，应尽量优化正则表达式，或者优先使用前缀匹配的ProxyPass指令来处理常规的版本路由，将RewriteRule保留给特殊场景，以保证代理服务器的吞吐性能。