Spring Boot 2.0.0升级报错：LogstashEncoder无法赋值给Appender变量

错误本质 #

你遇到的这个错误和logback-classic版本冲突无关，核心是logback配置文件的语法错误：把net.logstash.logback.encoder.LogstashEncoder编码器类错误配置成了Appender类型，编码器与Appender是logback中完全不同的组件，因此抛出类型不匹配异常。

修复步骤 #

• 找到项目中的logback配置文件（通常是src/main/resources/logback-spring.xml或logback.xml）
• 定位错误配置：你大概率写了类似以下的错误代码：

<appender name="LOGSTASH" class="net.logstash.logback.encoder.LogstashEncoder">
    <!-- 错误配置：编码器不能作为Appender的class -->
</appender>

• 修正配置：LogstashEncoder需要配合ConsoleAppender或RollingFileAppender使用，正确示例如下：

<appender name="LOGSTASH" class="ch.qos.logback.core.ConsoleAppender">
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <!-- 可添加编码器自定义配置，比如应用标识字段 -->
        <customFields>{"appName":"your-application-name"}</customFields>
    </encoder>
</appender>

• 兼容版本适配：Spring Boot 2.0.x建议搭配4.x版本的logstash-logback-encoder，若未指定版本，可在pom.xml中明确声明：

<dependency>
    <groupId>net.logstash.logback</groupId>
    <artifactId>logstash-logback-encoder</artifactId>
    <version>4.11</version>
</dependency>

• 无需排除Spring Boot自带的logback-classic：Spring Boot 2.0.0引入的logback-classic 1.2.x是稳定兼容版本，排除会导致应用启动失败。

内容的提问来源于stack exchange，提问作者Taoufik J