这是本节的多页打印视图。点击此处打印.

6.7 常见问题

1: 6.7.1 常见问题列表(请搜索查询)

1 - 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>