1. 综述
最近在学习shenyu网关,把学到的一些内容记录在博客中,一是为了方便以后查阅,二是希望和大家交流分享,有理解错误的地方还望大家批评指正。
神禹项目接触的还不是很深入,关于神禹网关,可以看一下官网的文档,对于入门还是比较有帮助的,官网地址如下:Apache ShenYu 介绍 | Apache ShenYu 。
我画了一个简图,用来说明神禹网关启动时几个主要的项目之间的关系,如下图所示,随着学习的深入,我还会完善这个图。
网关启动时需要先启动shenyu-admin,后启动shenyu-bootstrap。shenyu-admin是一个管理平台,启动后可以访问本地接口http://localhost:9095 ,使用默认用户名和密码: admin 和 123456来访问。
shenyu-bootstrap是网关核心,它是个承载插件的航母,网关功能都通过插件来实现。
启动方式可以根据官网文档操作,非常简单,我使用的是本地部署的方式。
2. 启动shenyu-admin时遇到的小问题
我启动shenyu-admin项目时遇到一点儿小问题,错误信息如下所示
Caused by: java.lang.IllegalStateException: Cannot load driver class: com.mysql.jdbc.Driver
at org.springframework.util.Assert.state(Assert.java:97)
at org.springframework.boot.autoconfigure.jdbc.DataSourceProperties.determineDriverClassName(DataSourceProperties.java:241)
at org.springframework.boot.autoconfigure.jdbc.DataSourceProperties.initializeDataSourceBuilder(DataSourceProperties.java:193)
at org.springframework.boot.autoconfigure.jdbc.DataSourceConfiguration.createDataSource(DataSourceConfiguration.java:48)
at org.springframework.boot.autoconfigure.jdbc.DataSourceConfiguration$Hikari.dataSource(DataSourceConfiguration.java:90)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at org.springframework.beans.factory.support.SimpleInstantiationStrategy.instantiate(SimpleInstantiationStrategy.java:154)
... 86 common frames omitted
3. 问题解决
3.1 尝试方法1-修改jar包版本和mysql driver class
3.1.1 初始环境说明
1. 数据库版本
我的mysql数据库版本是 5.7.37,
2. mysql-connector-java jar 包版本
shenyu使用的mysql的jar包版本是 8.0.29,maven依赖如下
<mysql.version>8.0.29</mysql.version>
3. shenyu-admin配置的 mysql driver-class-name
driver-class-name: com.mysql.cj.jdbc.Driver
3.1.2 环境修改
1. 修改jar包版本为5.1.49
<mysql.version>5.1.49</mysql.version>
2. 修改shenyu-admin配置的mysql driver-class-name为
driver-class-name: com.mysql.jdbc.Driver
3.1.3 结论
启动shenyu-admin测试,发现问题依旧,多次核对配置后,确认配置正确,报错原因,持续思考中...
3.2 修改pom 依赖,问题解决
经过排查,我发现pom文件中mysql的依赖是这样写的,重点是这里的scope,它的值是provided。把scope注释掉后,问题解决
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
<scope>provided</scope>
</dependency>
4.错误原因分析
具体的错误原因,就要看下scope的取值,及每个值的意义了,scope的取值共有5个,意义如下:
- 1. compile(编译范围 默认)
编译范围依赖在所有的classpath 中可用,同时它们也会被打包。
- 2. provided(已提供)
provided 依赖只有在当JDK 或者一个容器已提供该依赖之后才使用。例如, 如果你开发了一个web 应用,你可能在编译的classpath 中需要可用的Servlet API 来编译一个servlet,但是你不会想要在打包好的WAR 中包含这个Servlet API;这个Servlet API JAR 由你的应用服务器或者servlet 容器提供。已提供范围的依赖在编译classpath (不是运行时)可用。它们不是传递性的,也不会被打包。
- 3. runtime(运行时)
runtime 依赖在运行和测试系统的时候需要,但在编译的时候不需要
- 4. test(测试)
test范围依赖 在一般的编译和运行时都不需要,它们只有在测试编译和测试运行阶段可用。
- 5. system(系统)
system范围依赖与provided 类似,但是你必须显式的提供一个对于本地系统中JAR 文件的路径。这么做是为了允许基于本地对象编译,而这些对象是系统类库的一部分。这样的构件应该是一直可用的,Maven 也不会在仓库中去寻找它。如果你将一个依赖范围设置成系统范围,你必须同时提供一个 systemPath 元素。注意该范围是不推荐使用的(你应该一直尽量去从公共或定制的 Maven 仓库中引用赖)。
scope的值及说明,我参考的此篇文章 maven中scope的范围_鹤野云间的博客-CSDN博客_maven scope 取值范围。