SpringMVC 开发报错总结

今天药忘吃喽~ 2022-12-17 03:25 277阅读 0赞

## 报错一：Tomcat启动时中文乱码 ##

【报错描述】第一次下载或者打开Tomcat时可能在控制台会出现中文乱码问题。  
【报错原因】Tomcat的内部编码是UTF-8，但是Windows系统的编码是GBK，在日志显示的时候，将Tomcat的日志显示编码改为GBK即可。  
【解决方案】

1.  打开Tomcat安装目录下的conf/logging.properties文件，我的本机目录是：D:\\Program Files (x86)\\apache-tomcat-9.0.39\\conf\\logging.properties，找到java.util.logging.ConsoleHandler.encoding 条目，将其改为GBK。

java.util.logging.ConsoleHandler.encoding = GBK

1.  打开Tomcat安装目录下的conf/server.xml文件，添加`URIEncoding="UTF-8"`。

Tomcat的中文乱码问题即可解决。

## 报错二：Spring依赖版本问题 ##

【报错描述】Caused by: java.lang.IllegalArgumentException: 找到多个名为spring\_web的片段。  
【报错原因】项目用Maven引入依赖，本机有Maven仓库，但是开发时又存在lib目录，本机lib目录位置：E:\\IdeaProjects\\project-management-system\\src\\main\\webapp\\WEB-INF\\lib，两个目录中Spring版本存在冲突。  
【解决方案】开发时删除lib目录，上线部署时再加上lib目录即可。

## 报错三：MySQL版本冲突 ##

【报错描述】  
com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: Client does not support authentication protocol requested by server; consider upgrading MySQL client  
【报错原因】代码中的MySQL驱动版本与连接的数据库版本存在冲突，更新pom.xml中的Maven依赖为数据库的版本即可。  
【解决方案】  
代码中原有的pom.xml坐标：

<dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
    </dependency>

数据库版本为：

C:\Users\Administrator>mysql --version
    mysql  Ver 8.0.22 for Win64 on x86_64 (MySQL Community Server - GPL)

将代码中的pom.xml坐标改为：

<dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.22</version>
    </dependency>

旧的MySQL的JDBC驱动的类名已经废弃：com.mysql.jdbc.Driver  
新的MySQL的JDBC驱动的类名为：com.mysql.cj.jdbc.Driver

## 报错四：Error:java: 错误: 不支持发行版本 5 ##

【报错描述】本地JDK版本为11.0.2，编译SpringMVC程序，在Intellij IDEA中报错如下：

Error:java: 错误: 不支持发行版本 5

用PowerShell打开，运行`mvn jetty:run`，报错如下：

org.apache.jasper.JasperException: PWC6033: Error in Javac compilation for JSP
    
    PWC6199: Generated servlet error:
    不再支持源选项 5。请使用 6 或更高版本。
    
    PWC6199: Generated servlet error:
    不再支持目标选项 1.5。请使用 1.6 或更高版本。

【报错原因】IDEA中原来的语言级别为5，不兼容JDK 11，全部改为11即可。  
【解决方案】  
**step1.** 点击File->Project Structure->Project，将SDK和Project language level都改为11。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center][]

**step2.** 点击File->Project Structure->Modules，将language level改为11。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1][]

**step3.** 点击Settings->Build, Execution, Deployment->Compiler->Java Compiler，将Project bytecode version和Target bytecode version都改为11。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2][]

**step4.** 重新编译，编译成功。

## 报错五：本地图片无法加载 ##

【报错描述】  
图片文件存放在本地，数据库中存储的图片路径为：

/upload/images/item/shopcategory/1.png

该本地图片在页面中无法加载。  
【解决办法】  
在 Tomcat 的server.xml文件中配置如下：

意为：将 path 所指路径替换为 docBase 所指路径，即将

/upload/images/item/shopcategory/1.png

替换为：

E://work/image/upload/images/item/shopcategory/1.png

这就将数据库中存储的相对路径替换为本地的绝对路径。

> server.xml 中 docBase 和 path 的关系梳理  
> 将 path 的路径替换成 docBase 的值，即替换成绝对值根路径  
> 相对路径里必须有 path 前缀，如这里必须有 /upload  
> 相对路径的 path 被 docBase 替换后，确保图片存在于该绝对路径下

## 报错六：No archetype found in remote catalog. Defaulting to internal catalog ##

【报错描述】使用org.apache.maven.archetypes:maven-archetype-webapp创建SpringMVC Web项目时后，控制台报错：No archetype found in remote catalog. Defaulting to internal catalog。  
【报错原因】IDEA找不到archetype-catalog.xml文件。  
【解决办法】  
**step1.** 下载archetype-catalog.xml  
下载地址：https://repo1.maven.org/maven2/archetype-catalog.xml  
**step2.** 存放到仓库根目录  
例如；我的仓库是`D:\Program Files (x86)\apache-maven-3.6.3\repository`，则放到`D:\Program Files (x86)\apache-maven-3.6.3\repository\archetype-catalog.xml`  
**step3.** 添加参数-DarchetypeCatalog=local

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3][]

**step4.** 重启 IDEA。该报错解除。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/df6a9eda950948b9ae29651ea7339740.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/183ab1d93c684dbeb6ab10dd486f9bdd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/e9cd662fee8e436182e39be140890f79.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/12d2fbe1193f45a7beca3294dee37241.png