Java REST Web项目URL优化：隐藏项目路径实现简洁访问

嘿，这个问题我之前帮不少开发者捋过，其实要把冗长的URL（比如www.mydomain.com/MyProject/pages/login.jsp）改成用户友好的www.mydomain.com/login.jsp，有几种实用的方案，根据你的项目场景选就行：

1. 直接修改Servlet容器的上下文路径（最直接高效） #

默认情况下，Java Web项目的上下文路径就是你的项目名称（这里是MyProject），把它改成根路径（空字符串），就能去掉URL里的/MyProject部分。以Tomcat为例，有三种常用方式：

• 修改WAR包名称：把你的项目打包后的MyProject.war改成ROOT.war，Tomcat会自动把这个WAR作为根上下文部署，访问www.mydomain.com就直接指向你的项目。
• 修改Tomcat的server.xml：在<Host>标签内添加一个<Context>元素，指定空路径指向你的项目：

  <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
      <!-- 其他配置 -->
      <Context path="" docBase="MyProject" reloadable="true"/>
  </Host>
  

• IDE开发环境配置：如果你用IDEA或Eclipse，在项目的运行配置里，把“上下文路径”（Context Path）改成空字符串，本地调试时就能直接用短URL访问。

这一步完成后，URL就变成了www.mydomain.com/pages/login.jsp，接下来再处理掉/pages部分。

2. 用URL重写过滤器处理/pages前缀 #

如果不想动容器配置，或者需要更灵活的URL规则，可以用Tuckey URLRewriteFilter来实现内部转发：

1. 引入依赖（Maven项目为例）：

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

2. 在web.xml中配置过滤器：

   <filter>
       <filter-name>UrlRewriteFilter</filter-name>
       <filter-class>org.tuckey.web.filters.urlrewrite.UrlRewriteFilter</filter-class>
   </filter>
   <filter-mapping>
       <filter-name>UrlRewriteFilter</filter-name>
       <url-pattern>/*</url-pattern>
   </filter-mapping>
   

3. 编写重写规则：在项目的WEB-INF目录下创建urlrewrite.xml，添加规则让用户访问的/login.jsp内部转发到/pages/login.jsp（如果已经改了上下文路径的话）：

   <urlrewrite>
       <rule>
           <from>^/login.jsp$</from>
           <to>/pages/login.jsp</to>
       </rule>
       <!-- 可以添加其他页面的规则，比如/home.jsp对应/pages/home.jsp -->
   </urlrewrite>
   

3. Spring MVC项目专属：用路由和视图解析器优雅实现 #

如果你的项目是基于Spring MVC的，那直接用框架自带的功能就能搞定，不用额外加过滤器：

1. 配置视图解析器：在application.properties（或Spring XML配置）里设置视图的前缀和后缀，让Controller返回的视图名自动映射到pages目录下的JSP：

   spring.mvc.view.prefix=/pages/
   spring.mvc.view.suffix=.jsp
   

2. 编写Controller映射短URL：创建一个Controller类，把/login.jsp映射到对应的视图：

   @Controller
   public class LoginController {
       @RequestMapping("/login.jsp")
       public String showLoginPage() {
           // 返回的"login"会被视图解析器解析为/pages/login.jsp
           return "login";
       }
   }
   

配合第一步的上下文路径修改，用户访问www.mydomain.com/login.jsp就会直接渲染/pages/login.jsp的内容，完全看不到冗长的路径。

注意事项 #

• 处理URL简化后，要确保静态资源（CSS、JS、图片）的路径正确，避免出现404错误。比如原来的/MyProject/css/style.css要改成/css/style.css（上下文改根后）。
• 生产环境和开发环境的配置要保持一致，避免部署后出现URL不匹配的问题。
• 如果考虑SEO，要确保简化后的URL是唯一的，避免同一个页面有多个URL导致重复内容扣分。

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