项目web.xml中配置DispatcherServlet时，红色波浪线报错（Cannot resolve Servlet ‘DispatcherServlet‘）

迈不过友情╰ 2023-10-09 23:46 30阅读 0赞

> 编译软件：IntelliJ IDEA 2019.2.4 x64  
> 操作系统：win10 x64 位 家庭版  
> Maven版本：apache-maven-3.6.3  
> spring mvc版本：5.3.1

--------------------

#### 目录 ####

*  项目案例场景
 *   *  需求分析
     *   *  1：获取所有员工信息
         *  2：添加操作去添加员工的页面
         *  3：添加操作-添加员工
         *  4：删除员工
         *  5：修改操作去修改员工的页面
 *  问题描述：在项目web.xml中配置DispatcherServlet时，红色波浪线报错（Cannot resolve Servlet ‘DispatcherServlet‘）
 *  原因分析
 *  解决方案：检查Spring Mvc是否可以正确扫描加载到web.xml文件，若不能，重新设置选择web.xml路径

--------------------

## 项目案例场景 ##

> **SpringMvc框架下的Restful的CRUD的demo 练习**

### 需求分析 ###

#### 1：获取所有员工信息 ####

1.  URL：/emps
2.  请求方式：GET
3.  显示效果如下所示：  
    ![在这里插入图片描述][8256b04a34114f76acd4bdd6fd8b60ca.png]

#### 2：添加操作去添加员工的页面 ####

1.  URL：/toAddPage
2.  请求方式：GET
3.  显示效果  
    ![在这里插入图片描述][e5abcfb2d98e4bfa95cbc4827c2ca27e.png]

#### 3：添加操作-添加员工 ####

1.  URL：/emps
2.  请求方式：POST
3.  添加成功之后【重定向到查询所有员工的UR】

> ps： **我这里实现的思路是先添加员工，然后调用并返回查询所有员工的方法的返回值响应给浏览器**

Controller层相关实现代码如下：

@GetMapping("/emps")
       /**
        * 配置URL [/emps]，服务器使用ModelAndView对象处理响应数据
        *  查询所有员工信息
        */
        public ModelAndView selectAllEmps(){
        
    
           ModelAndView mv=new ModelAndView();
           mv.setViewName("emps");
           //将list集合employees存放进请求域中
           Collection<Employee> employees = employeeService.showAllEmps();
           mv.addObject("employees",employees);
           return mv;
       }
    
    
     /**
         * 添加员工
         * @param employee
         * @return
         */
       @PostMapping("/emps")
       //使用pojo入参
       public ModelAndView addEmps(Employee employee){
        
           boolean b = employeeService.addEmp(employee);
           System.out.println(b==true?"添加成功":"添加失败");
           return selectAllEmps();
       }

1.  需求显示效果

![在这里插入图片描述][be4092cfdeea4e3ebc1c6dffa59ca00c.png]

#### 4：删除员工 ####

1.  URL：emps/id
2.  请求方式：DELETE、
3.  点击删除按钮弹出提示框
4.  删除成功之后同样重定向到查询所有员工的URL

> ps： **我这里实现的思路是先删除员工，然后调用并返回查询所有员工的方法的返回值响应给浏览器【转发】，并非是重定向**

1.  显示效果：对应的员工信息从前端页面中直接删除

#### 5：修改操作去修改员工的页面 ####

1.  URL：/toUpdatePage/\{id)
2.  请求方式：GET
3.  根据员工的id从数据库中查询员工信息
4.  员工id不能修改，设置为只读
5.  效果如下：

![在这里插入图片描述][733087f501a84374b19a40af0cf9cb9c.png]

--------------------

## 问题描述：在项目web.xml中配置DispatcherServlet时，红色波浪线报错（Cannot resolve Servlet ‘DispatcherServlet‘） ##

如下所示：  
![在这里插入图片描述][f82acde806e145269a8aeaa29ed6f920.png]

--------------------

## 原因分析 ##

> **出现这个报警是因为Spring MVC 框架无法找到名称为 “dispatcherServlet” 的 Bean。**

Spring MVC 框架会在启动时查找名为 dispatcherServlet 的 Servlet Bean，并将其注册到 Servlet 容器中。**`如果该 Bean 无法正常创建或者未能被正确地扫描和加载，就会引发 "Cannot resolve Servlet 'dispatcherServlet'" 的异常。`**

查询相关资料，我发现有几个常见的原因可能导致这个问题：

*  ①`web.xml 中的配置错误` **，在 Web 应用程序的 web.xml 文件中定义了 servlet 和 filter 的映射关系**，如果其中与 Spring MVC 中相应的配置不匹配，就会导致前端控制器 DispatcherServlet 无法找到对应的 Bean。
 *  ②web.xml中相关配置代码正确，**`可能是 Spring MVC框架不能正确加载或扫描该web.xml文件`**
 *  ③**如果Spring MVC 框架的版本更新到了较新的版本，但是没有相应修改相关配置，也容易导致该错误的出现**
 *  ④**未导入相关jar包**

综上所述，首先我的Spring Mvc框架的jar包是基于5.3.1的版本，其他依赖也是适配5.3.1的Spring Mvc版本且已经正确导入。**故原因③ & ④排除**。  
![在这里插入图片描述][6c358a7131984c2bbd348066d7048cf8.png]  
![在这里插入图片描述][76e2525d28114275b7af656d918ecf69.png]

web.xml中关于DispatcherServlet的相关配置代码都是从上一个工程文件直接复制过来的，故web.xml配置正确，**排除原因①**，检查分析原因③，检查Spring Mvc是否可以正确扫描加载到web.xml文件。打开”Project Structure“，**`我发现我的Spring Mvc模块中的web工程引用了项目中另一个web工程的web.xml文件`**，难怪报错！！！

--------------------

## 解决方案：检查Spring Mvc是否可以正确扫描加载到web.xml文件，若不能，重新设置选择web.xml路径 ##

> **①找到下面的图标，点击打开“Project Structure“，或者按快捷键”Ctrl+Alt+Shift+S“打开。**

![在这里插入图片描述][9ae02467f7bc4a3d9b38960d157a359b.png]

> **②”Modules“ -> 选中你要检查的spring mvc模块 -> 选中’Web" -> 检查两个路径是否正确【web.xml所在的路径与web.xml相关联的web工程根路径是否正确】（`ps，我是这里引用了项目中另一个web工程的web.xml文件而导致的飘红`）**

![在这里插入图片描述][98c2c7c0e91346d1be31c6dbfe5b8d6f.png]

**重新修改引用web.xml的路径，使之Spring Mvc可以正确加载该web.xml即可**

> **③依次点击 Maven中的 clear 与 compile,，便可解决问题**

![在这里插入图片描述][3b54e46bee9141d18ee81409c8883aed.png]

[8256b04a34114f76acd4bdd6fd8b60ca.png]: https://img-blog.csdnimg.cn/8256b04a34114f76acd4bdd6fd8b60ca.png
[e5abcfb2d98e4bfa95cbc4827c2ca27e.png]: https://img-blog.csdnimg.cn/e5abcfb2d98e4bfa95cbc4827c2ca27e.png
[be4092cfdeea4e3ebc1c6dffa59ca00c.png]: https://img-blog.csdnimg.cn/be4092cfdeea4e3ebc1c6dffa59ca00c.png
[733087f501a84374b19a40af0cf9cb9c.png]: https://img-blog.csdnimg.cn/733087f501a84374b19a40af0cf9cb9c.png
[f82acde806e145269a8aeaa29ed6f920.png]: https://img-blog.csdnimg.cn/f82acde806e145269a8aeaa29ed6f920.png
[6c358a7131984c2bbd348066d7048cf8.png]: https://img-blog.csdnimg.cn/6c358a7131984c2bbd348066d7048cf8.png
[76e2525d28114275b7af656d918ecf69.png]: https://img-blog.csdnimg.cn/76e2525d28114275b7af656d918ecf69.png
[9ae02467f7bc4a3d9b38960d157a359b.png]: https://img-blog.csdnimg.cn/9ae02467f7bc4a3d9b38960d157a359b.png
[98c2c7c0e91346d1be31c6dbfe5b8d6f.png]: https://img-blog.csdnimg.cn/98c2c7c0e91346d1be31c6dbfe5b8d6f.png
[3b54e46bee9141d18ee81409c8883aed.png]: https://img-blog.csdnimg.cn/3b54e46bee9141d18ee81409c8883aed.png