软件版本差异造成的异常

前提

作为异常及其解决方案的收集贴，这篇博文主要记录由软件版本差异造成的异常。

---

异常1：java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException.

情境： 将在JDK 8环境下开发并运行过一段时间的工程，部署到JDK 12环境下的服务器上。

触发异常的原因： Java 9中引入了模块的概念，默认情况下，J2SE聚合模块在类路径（或者说模块路径）上可用。正如其名称所暗示的，J2SE汇聚模块不再包含J2EE的API。而JAXB属于J2EE的API。

解决方案： 在工程中额外添加上JAXB API的依赖即可。

<!-- https://mvnrepository.com/artifact/javax.xml.bind/jaxb-api -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>

---

异常2：tomcat用户权限已设置但仍然报403错误

情境： 已经在tomcat-users.xml中设置了用户权限，但通过maven的tomcat7-maven-plugin向tomcat8执行远程热部署时仍然报403错误，说所提供的用户没有权限。

触发异常的原因： tomcat8默认启用了网段限制，只有127网段局域网的机器，能够有访问权限，其他网段访问会报403。

解决方案： 分别修改webapps文件夹下的manager和host-manager两个工程，将META-INF中context.xml的内容由

      <Valve className="org.apache.catalina.valves.RemoteAddrValve"
             allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

改为

      <Valve className="org.apache.catalina.valves.RemoteAddrValve"
             allow="\d+\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

---

异常3：将MySQL-Connector从5换到8之后的各种报错

情境： 将MySQL-Connector从5.1.46版本升级到8.1.12之后会报一些错

触发的原因： MySQL-Connector的官方做了较大幅度的更新，因此要求我们在调用的时候做一些配置上的改变。

解决方案：

① 将JDBC的driver由com.mysql.jdbc.Driver改为com.mysql.cj.jdbc.Driver
② 在URL中加上userSSL=false或useSSL=true，指定是否使用SSL连接
③ 在URL中加上serverTimezone=GMT%2B8，指定时区为我国所在的东八区

---

后记

很多软件在更新之后不会完全的对下兼容，或者有一些默认设置发生了改变，值得记录下来，以便下次遇到时快速解决。