SpringCloudAlibaba微服务启动报错原因及解决方案

控制台日志打印异常信息

17:14:12.648 [main] DEBUG org.springframework.boot.diagnostics.LoggingFailureAnalysisReporter - Application failed to start due to an exception
org.springframework.cloud.commons.ConfigDataMissingEnvironmentPostProcessor$ImportException: No spring.config.import set
        at org.springframework.cloud.commons.ConfigDataMissingEnvironmentPostProcessor.postProcessEnvironment(ConfigDataMissingEnvironmentPostProcessor.ja va:82)
        at org.springframework.boot.env.EnvironmentPostProcessorApplicationListener.onApplicationEnvironmentPreparedEvent(EnvironmentPostProcessorApplicationListener.ja va:102)
        at org.springframework.boot.env.EnvironmentPostProcessorApplicationListener.onApplicationEvent(EnvironmentPostProcessorApplicationListener.ja va:87)
        at org.springframework.context.event.SimpleApplicationEventMulticaster.doInvokeListener(SimpleApplicationEventMulticaster.ja va:178)
        at org.springframework.context.event.SimpleApplicationEventMulticaster.invokeListener(SimpleApplicationEventMulticaster.ja va:171)
        at org.springframework.context.event.SimpleApplicationEventMulticaster.multicastEvent(SimpleApplicationEventMulticaster.ja va:145)
        at org.springframework.context.event.SimpleApplicationEventMulticaster.multicastEvent(SimpleApplicationEventMulticaster.ja va:133)
        at org.springframework.boot.context.event.EventPublishingRunListener.environmentPrepared(EventPublishingRunListener.ja va:85)
        at org.springframework.boot.SpringApplicationRunListeners.lambda$environmentPrepared$2(SpringApplicationRunListeners.ja va:66)
        at ja va.base/ja va.util.ArrayList.forEach(ArrayList.ja va:1541)
        at org.springframework.boot.SpringApplicationRunListeners.doWithListeners(SpringApplicationRunListeners.ja va:120)
        at org.springframework.boot.SpringApplicationRunListeners.doWithListeners(SpringApplicationRunListeners.ja va:114)
        at org.springframework.boot.SpringApplicationRunListeners.environmentPrepared(SpringApplicationRunListeners.ja va:65)
        at org.springframework.boot.SpringApplication.prepareEnvironment(SpringApplication.ja va:344)
        at org.springframework.boot.SpringApplication.run(SpringApplication.ja va:302)
        at org.springframework.boot.SpringApplication.run(SpringApplication.ja va:1300)
        at org.springframework.boot.SpringApplication.run(SpringApplication.ja va:1289)
        at com.mall.user.UserApplication.main(UserApplication.ja va:15)
17:14:12.651 [main] ERROR org.springframework.boot.diagnostics.LoggingFailureAnalysisReporter - 
***************************
APPLICATION FAILED TO START
***************************
Description:
No spring.config.import property has been defined
Action:
Add a spring.config.import=nacos: property to your configuration.
        If configuration is not required add spring.config.import=optional:nacos: instead.
        To disable this check, set spring.cloud.nacos.config.import-check.enabled=false.

配置文件

相信不少朋友在整合Spring Cloud Alibaba时都遇到过这个经典的启动报错。明明在application.yml里没配置spring.cloud.nacos.config，为什么控制台日志却一直提示你配置spring.config.import呢？这看起来有点矛盾。

原因及解决方案

其实，问题的根源非常清晰。关键在于，你的mall-user/pom.xml文件里引入了spring-cloud-starter-alibaba-nacos-config这个依赖。从Spring Cloud Alibaba 2021.0.5.0版本开始，只要你引入了这个依赖，框架就会强制校验你的spring.config.import属性是否被配置——这个校验逻辑是独立于application.yml里有没有spring.cloud.nacos.config配置块的。

换句话说，框架的逻辑是：“你既然引入了配置中心的依赖，我就默认你要用配置中心，所以你必须告诉我配置从哪里导入。” 这也就解释了为什么你会看到那个看似矛盾的报错信息。

搞清楚了原因，解决起来就简单了。这里提供三种修复方案，根据你的实际场景任选其一即可。

方案一：禁用强制检查（最简单）

spring:
  cloud:
    nacos:
      config:
        import-check:
          enabled: false

这个方案最适合那些只需要使用Nacos的服务发现功能，而完全不需要其配置中心功能的场景。加上这行配置，就等于告诉框架：“别检查了，我知道我没配导入，但我就是不用配置中心。” 服务就能顺利启动了。

方案二：补上spring.config.import

spring:
  config:
    import:
      - optional:nacos:mall-user.yaml?refreshEnabled=true

如果你的项目确实需要从Nacos配置中心加载配置，那么这才是正解。在配置文件中补上spring.config.import属性，指向Nacos上对应的配置文件。这里有个细节需要注意：之前有开发者反馈遇到MalformedInputException异常，排查后发现，问题往往出在Nacos服务器上存储的YAML文件编码不是合法的UTF-8。所以，在配置之前，最好先确认一下Nacos上文件的编码格式。

方案三：从 pom.xml 移除 config 依赖（最彻底）

如果经过评估，你的服务确实完全不需要Nacos配置中心，只用它的服务注册与发现功能，那么最彻底的方案就是“釜底抽薪”。直接打开mall-user/pom.xml文件，找到并删除下面这段依赖：

    com.alibaba.cloud
    spring-cloud-starter-alibaba-nacos-config

这样一来，框架根本不知道你有使用配置中心的意图，自然也就不会进行强制校验了。

那么，到底该选哪个方案呢？一个比较稳妥的建议是：先用方案一快速恢复服务启动，保证开发或测试流程不被阻塞。等项目稳定后，如果后续确实有使用配置中心的需求，再切换到方案二，并同步处理好Nacos上的文件编码问题。这样既能快速解决问题，也为未来的架构演进留好了接口。