6.7.1 常见问题列表(请搜索查询)
使用问题
arklet 安装问题
现象
通过 go install 无法安装 arkctl,执行命令如:
go install koupleless.alipay.com/koupleless/v1/arkctl@latest
报错信息如下:
go: koupleless.alipay.com/koupleless/v1/arkctl@latest: module koupleless.alipay.com/koupleless/v1/arkctl: Get "https://proxy.golang.org/koupleless.alipay.com/koupleless/v1/arkctl/@v/list": dial tcp 142.251.42.241:443: i/o timeout
解决方式
arkctl 是作为 koupleless 子目录的方式存在的,所以没法直接 go get,可以从这下面下载执行文件, 请参考安装 arkctl
模块构建问题
maven 版本太低
现象
构建时,
- 报错 Unable to parse configuration of mojo com.alipay.sofa:sofa-ark-maven-plugin:.*:repackage for parameter excludeArtifactIds
- 报错 com.google.inject.ProvisionException: Unable to provision, see the following errors:
- 报错 Error injecting: private org.eclipse.aether.spi.log.Logger org.apache.maven.repository.internal.DefaultVersionRangeResolver.logger
- 报错 Caused by: java.lang.IllegalArgumentException: Can not set org.eclipse.aether.spi.log.Logger field org.apache.maven.repository.internal.DefaultVersionRangeResolver.logger to org.eclipse.aether.internal.impl.slf4j.Slf4jLoggerFactory
原因
maven 版本太低
解决方式
需升级到 3.6.1 及以上
配置问题
application.properties 配置
现象
spring.application.name must be configured
原因
application.properties 里未配置 spring.application.name
解决方式
application.properties 里配置 spring.application.name
SOFABoot 基座或模块启动因 AutoConfiguration 失败
现象
报错 The following classes could not be excluded because they are not auto-configuration classes: org.springframework.boot.actuate.autoconfigure.startup.StartupEndpointAutoConfiguration
原因
SOFABoot 正确引入需要同时引入 spring-boot-actuator-autoconfiguration,因为 sofa-boot 里通过代码定义了 spring.exclude.autoconfiguration = org.springframework.boot.actuate.autoconfigure.startup.StartupEndpointAutoConfiguration
, 当启动时找不到该类时就会报错。
解决方式
基座或模块里引入 sprign-boot-actuator-autoconfiguration
模块发rest服务webContextPath冲突
现象
报错 org.springframework.context.ApplicationContextException: Unable to start web server; nested exception is java.lang.IllegalArgumentException: Child name xxx is not unique
原因
webContextPath 冲突
解决方式
检查其他模块是否设置相同的webContextPath
jvm参数配置错误
现象
报错 Error occurred during initialization of VM
原因
报错 Error occurred during initialization of VM,一般是jvm参数配置有问题
解决方式
用户侧检查 jvm 参数配置
运行时问题
koupleless 依赖缺失
现象
- 模块安装时,报错 com.alipay.sofa.ark.exception.ArkLoaderException: [ArkBiz Loader] module1:1.0-SNAPSHOT : can not load class: com.alipay.sofa.koupleless.common.spring.KouplelessApplicationListener
原因
koupleless 依赖缺失
解决方式
请在模块里面添加如下依赖:
<dependency>
<groupId>com.alipay.sofa.koupleless</groupId>
<artifactId>koupleless-app-starter</artifactId>
<version>${koupleless.runtime.version}</version>
</dependency>
或者升级 koupleless 版本到最新版本
koupleless 版本较低
现象
- 模块安装报错 Master biz environment is null
- 模块静态合并部署无法从指定的目录里找到模块包
解决方式
升级 koupleless 版本到最新版本
<dependency>
<groupId>com.alipay.sofa.koupleless</groupId>
<artifactId>koupleless-app-starter</artifactId>
<version>${最新版本号}</version>
</dependency>
类缺失
现象
- 报错 java.lang.ClassNotFoundException
- 报错 java.lang.NoClassDefFoundError
原因
模块/基座 找不到类
解决方式
请根据 模块类缺失 和 基座类缺失 进行排查。
模块类缺失
现象
ArkBiz Loader.*can not load class
原因
模块里缺失对应类的依赖!
解决方式
检查模块里是否包含该类的依赖,如果没有,请增加相应的依赖。
基座类缺失
现象
ArkLoaderException: Post find class XXX occurs an error via biz ClassLoaderHook
原因
设置委托给基座加载的类,但基座里找不到对应类的依赖,或者依赖的版本不对。
解决方式
基座添加相应依赖,或者修改依赖版本。
模块依赖的类存在多个不同的来源
现象
- 报错 java.lang.LinkageError
- 报错 java.lang.ClassCastException
- 报错 previously initiated loading for a different type with name
原因
该类在基座和模块间引入了多个相同的依赖,加载到的类可能来自于不同 ClassLoader
解决方式
在模块主 pom 中,把类所在的包设置为 provided。(做好模块瘦身和基座与模块间的依赖管理。)
方法缺失
现象
java.lang.NoSuchMethodError
原因
报出java.lang.NoSuchMethodError,可能存在存在jar包冲突、依赖未加载的情况
解决方式
请检查是否存在jar包冲突或依赖未加载。
模块直接使用基座数据源
现象
No operation is allowed after dataSource is closed
原因
模块里直接使用了基座里的 dataSource,模块卸载导致基座 dataSource 关闭
解决方式
dataSource 已经关闭,确认模块里是否通过 bean 获取方式直接使用了基座里的 dataSource
Bean 配置问题
现象
- 报错 org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: Invalid bean definition with name
- 报错 java.lang.IllegalArgumentException: JVM Reference
- 报错 Error creating bean with name
- 报错 BeanDefinitionStoreException: Invalid bean definition with name
- 报错 org.springframework.beans.FatalBeanException: Bean xx has more than one interface
- 报错 No qualifying bean of type
- 报错 BeanDefinitionStoreException: Invalid bean definition with name
原因
工程中 bean 配置问题
解决方式
- xml中是否错误配置了 bean, 或者依赖存在问题 2. bean初始化/Bean定义异常, 请检查业务逻辑
Spring Bean 重复定义
现象
There is already xxx bean
原因
业务编码问题:bean 重复定义
解决方式
检查业务侧代码
XML 配置问题
现象
Error parsing XPath XXX Cause: java.io.IOException: Could not find resource
原因
XML文件解析失败, 无法找到对应的依赖配置
解决方式
请用户排查解析失败问题
JMX 配置问题
现象
org.springframework.jmx.export.UnableToRegisterMBeanException: Unable to register MBean
原因
JMX 需要手动配置应用名称
解决方式
给基座加 -Dspring.jmx.default-domain=${spring.application.name} 启动参数
依赖配置
现象
Dependency satisfaction failed XXX java.lang.NoClassDefFoundError
原因
jar包依赖问题, class not found
解决方式
请检查 jar 包依赖, 工程中是否依赖了错误 jar 包, 进行修正
SOFA JVM Service 查找失败
现象
- 报错 can not find corresponding jvm service
- 报错 JVM Reference XXX can not find the corresponding JVM service
原因
JVM Reference 依赖的JVM 服务未找到
解决方式
请检查业务代码是否正确,对应的服务是否存在。
内存不足
现象
- 报错 Insufficient space for shared memory
- 报错 java.lang.OutOfMemoryError: Metaspace
原因
内存不足或内存溢出
解决方式
请替换或重启机器
hessian版本冲突
现象
Illegal object reference
原因
hessian版本冲突
解决方式
使用mvn dependency:tree查看依赖树,排掉冲突依赖
guice 版本较低
现象 报错 Caused by: java.Lang.ClassNotFoundException: com.google.inject.multibindings.Multibinder
原因
用户工程与 koupleless 里 guice 版本不一致,且版本较老
解决方式
升级 guice 版本到较新版本,如
<dependency>
<groupId>com.google.inject</groupId>
<artifactId>guice</artifactId>
<version>6.0.0</version>
</dependency>
SOFABoot 健康检查失败
现象
HealthCheck Failed
原因
Sofaboot工程HealthCheck失败
解决方式
请用户排查具体失败原因
需要模块瘦身
现象
- 报错 java.lang.IllegalArgumentException: Cannot instantiate interface org.springframework.context.ApplicationListener : com.alipay.sofa.koupleless.common.spring.KouplelessApplicationListener
- 报错 Caused by: java.lang.IllegalArgumentException: class com.alipay.sofa.koupleless.plugin.spring.BizApplicationContextInitializer is not assignable to interface org.springframework.context.ApplicationContextInitializer
原因
模块应该以provided方式引入 springboot 依赖,或者通过配置方式模块瘦身
解决方式
模块做好瘦身,参考这里:模块瘦身
模块与基座共库时,模块启动了基座的逻辑
现象
例如基座引入了 druid,但是模块里没有引入,按照设计模块应该不需要初始化 dataSource,但是如果遇到模块也初始化了 dataSource,那么该行为是不符合预期的,也可能导致报错。
解决方式
- 确保模块可以独立构建,也就是可以在模块的目录里执行
mvn clean package
,并且不会报错 - 升级 koupleless 版本到最新版本 1.0.0
模块启动无法初始化 EnvironmentPostProcessor
现象
模块启动时报这类错误信息 Unable to instantiate com.baomidou.mybatisplus.autoconfigure.SafetyEncryptProcessor [org.springframework.boot.en V.EnvironmentPostProcessor]
解决方式
模块main方法里启动 springboot 时指定 ResourceLoader 的 ClassLoader
SpringApplicationBuilder builder = new SpringApplicationBuilder(Biz1Application.class);
// set biz to use resource loader.
ResourceLoader resourceLoader = new DefaultResourceLoader(
Biz1Application.class.getClassLoader());
builder.resourceLoader(resourceLoader);
builder.build().run(args);
基座关闭的时候Tomcat报错
现象
基座关闭时,报错:Unable to stop embedded Tomcat
原因
基座关闭时,Tomcat 有自身关闭逻辑, koupleless 增加了关闭逻辑,导致基座关闭会尝试第二次关闭。该信息只是一个警告,不影响基座的正常关闭。
解决方式
无需处理
模块compile引入 tomcat启动导致报错 Caused by: java.lang.Error: factory already defined
现象
详细报错堆栈可以看这里
原因
模块 compile 引入了 tomcat,模块启动时 tomcat 会再次初始化,这时 TomcatURLStreamHandlerFactory 通过 URL::setURLStreamHandlerFactory 注册进 URL, 然后由于基座已经注册过一次,重复注册报错,详细看这里
解决方式
通过代码设置 TomcatURLStreamHandlerFactory.disable()
模块启动在 JdkDynamicAopProxy.getProxy
报错 xxx referenced from a method is not visible from class loader
原因
spring-core 是 6.0.9 的版本,内部逻辑存在bug,这里即使传入 BizClassLoader,也会因为 BizClassLoader 没有 parent 而强制切换 classLoader 成了 基座 ClassLoader
public Object getProxy(@Nullable ClassLoader classLoader) {
if (logger.isDebugEnabled()) {
logger.debug("Creating JDK dynamic proxy: " + this.advised.getTargetSource());
}
if (classLoader == null || classLoader.getParent() == null) {
// JDK bootstrap loader or platform loader
// use higher-level loader which can see spring infrastructure classes
classLoader = getClass().getClassLoader();
}
return Proxy.newProxyInstance(classLoader, this.proxiedInterfaces, this);
}
解决方式
使用 spring-core 更新版本,例如 6.0.11
Hessian 序列化反序列化不支持多应用(classLoader)
解决方式
参考 https://github.com/koupleless/koupleless/issues/196, 可以升级 hessian 版本到 4.x 以上,或者自定义多 ClassLoader 的 SerializerFactory
Hessian 序列化报错
现象
java.lang.RuntimeException: can’t get field offset on a hidden class: private final XXXXX$$Lambda$XXXX
java.lang.UnsupportedOperationException: can’t get field offset on a hidden class: private final XXXXX$$Lambda$XXXX
原因
Hessian 序列化时不支持 lambda 的隐藏类
解决方式
- 首先,将该序列化的类所在的依赖包放在基座中
- 然后,模块中依赖该依赖,但瘦身该依赖包,参考 模块瘦身
基座启动时报错 IllegalArgumentException: File must exist
原因
springboot 新版本更新了文件路径格式,导致部分对文件路径的逻辑发生错误,详见 https://github.com/koupleless/koupleless/issues/161
解决方式
springboot 打包插件里增加配置 <loaderImplementation>CLASSIC</loaderImplementation>
,回退会原有路径格式
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
<configuration>
<loaderImplementation>CLASSIC</loaderImplementation>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
Feedback
Was this page helpful?
Welcome propose feedback to community!
Welcome propose feedback to community, or improve this document directly.。