java.lang.IllegalArgumentException: 名为 [MyServlet]和 [com.example.MyServlet] 的servlet不能映射为一个url模式(url-pattern) [/test.do]

MyFilter类

package com.example;

import jakarta.servlet.*;
import jakarta.servlet.annotation.WebFilter;

import java.io.IOException;

// 过滤所有以 .do 结尾的请求
@WebFilter("*.do")
public class MyFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        System.out.println("MyFilter 初始化完成");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        System.out.println("请求进入 MyFilter，开始处理请求...");
        // 继续执行后续的过滤器或 Servlet
        chain.doFilter(request, response);
        System.out.println("请求离开 MyFilter，响应已处理完成");
    }

    @Override
    public void destroy() {
        System.out.println("MyFilter 销毁完成");
    }
}

MyServlet类

package com.example;

import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.io.PrintWriter;

// 处理 /test.do 请求
@WebServlet("/test.do")
public class MyServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.println("<html><body>");
        out.println("<h2>这是 MyServlet 处理的请求</h2>");
        out.println("</body></html>");
    }
}

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <!-- 配置过滤器 -->
    <filter>
        <filter-name>MyFilter</filter-name>
        <filter-class>com.example.MyFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>MyFilter</filter-name>
        <url-pattern>*.do</url-pattern>
    </filter-mapping>

    <!-- 配置 Servlet -->
    <servlet>
        <servlet-name>MyServlet</servlet-name>
        <servlet-class>com.example.MyServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>MyServlet</servlet-name>
        <url-pattern>/test.do</url-pattern>
    </servlet-mapping>

</web-app>

根据错误信息 名为 [MyServlet]和 [com.example.MyServlet] 的servlet不能映射为一个url模式 [/test.do]，这通常是由于 同一个 URL 模式被多个 Servlet 重复映射 导致的。以下是详细分析和解决方案：

错误原因

在 Tomcat 中，同一个 URL 模式（如 /test.do）不能同时被两个不同的 Servlet 映射，无论通过注解还是 web.xml 配置。错误信息中的 MyServlet 和 com.example.MyServlet 可能是以下两种情况：

  1. 注解与 web.xml 冲突：在 Servlet 类上使用了 @WebServlet("/test.do")，同时又在 web.xml 中手动配置了另一个 Servlet 映射到 /test.do。
  2. 重复配置：在 web.xml 中重复声明了同一个 Servlet 的映射。

解决方案

1. 检查 Servlet 注解与 web.xml 的配置

  • 示例代码中的冲突：

    • 在 MyServlet 类上有 @WebServlet("/test.do")。
    • 同时在 web.xml 中配置了 <servlet-mapping> 映射 /test.do 到 MyServlet。
    • 这会导致 Tomcat 认为两个不同的 Servlet（一个通过注解，一个通过 web.xml）映射到了同一个 URL。

  • 修复方法：

    • 删除 web.xml 中的 Servlet 配置，仅保留注解：

      java

      @WebServlet("/test.do") // 注解已配置 URL，无需在 web.xml 中重复
public class MyServlet extends HttpServlet { ... }
    • 或者 删除注解，仅使用 web.xml 配置：

      java

      public class MyServlet extends HttpServlet { ... } // 移除 @WebServlet 注解
       

      xml

      <!-- web.xml -->
<servlet>
    <servlet-name>MyServlet</servlet-name>
    <servlet-class>com.example.MyServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/test.do</url-pattern>
</servlet-mapping>
2. 检查是否有重复的 Servlet 映射
  • 确保 web.xml 中没有多个 <servlet-mapping> 指向同一个 URL 模式。例如：

    xml

    <!-- 错误示例：两个不同的 Servlet 映射到同一个 URL -->
<servlet-mapping>
    <servlet-name>AServlet</servlet-name>
    <url-pattern>/test.do</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>BServlet</servlet-name>
    <url-pattern>/test.do</url-pattern>
</servlet-mapping>

完整修复后的代码

1. 仅使用注解配置

java

package com.example;

import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

// 注解直接配置 URL，无需 web.xml
@WebServlet("/test.do") 
public class MyServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.println("<html><body>");
        out.println("<h2>这是 MyServlet 处理的请求</h2>");
        out.println("</body></html>");
    }
}
2. 仅使用 web.xml 配置

java

package com.example;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

// 移除 @WebServlet 注解
public class MyServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.println("<html><body>");
        out.println("<h2>这是 MyServlet 处理的请求</h2>");
        out.println("</body></html>");
    }
}

xml

<!-- web.xml -->
<web-app ...>
    <servlet>
        <servlet-name>MyServlet</servlet-name>
        <servlet-class>com.example.MyServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>MyServlet</servlet-name>
        <url-pattern>/test.do</url-pattern>
    </servlet-mapping>
</web-app>

其他注意事项

  1. 确保类路径正确：检查 web.xml 中的 <servlet-class> 是否与实际包路径一致（如 com.example.MyServlet）。
  2. 清理 Tomcat 缓存：删除 Tomcat 目录下的 work 和 temp 文件夹，避免旧配置残留。
  3. 重新部署项目：使用 IDE 的重新部署功能或手动替换 webapps 目录中的项目文件。

通过以上步骤，应该能解决 Servlet 映射冲突的问题。如果仍有异常，请检查 Tomcat 日志中的其他错误信息。

# java # servlet # 开发语言
Logo
开源鸿蒙跨平台开发者社区

开源鸿蒙跨平台开发社区汇聚开发者与厂商，共建“一次开发，多端部署”的开源生态，致力于降低跨端开发门槛，推动万物智联创新。

更多推荐

轻量级与模块化：面向移动端的Web3钱包开发框架选型与技术精简策略

第一，核心逻辑下沉，远离UI线程。以Tether开源的WDK（Wallet Development Kit）为例，其React Native核心库将签名、派生密钥等密码学操作封装为独立的“工作流包”（worklet bundle），运行在专线线程而非UI线程。当钱包开发从“全栈自研”走向“框架组装”，开发团队的核心竞争力将从底层技术实现，转向对特定场景用户体验的深度理解。然而，钱包开发仍面临一个结

avatar 开源鸿蒙跨平台开发者社区
cover

《OpenHarmony 应用开发踩坑实录：6 个坑，帮你少走一半弯路》

avatar 开源鸿蒙跨平台开发者社区
cover

开源鸿蒙桌面端实战复盘：PC专项积分赛三方库适配与上分技巧

avatar 开源鸿蒙跨平台开发者社区