Spring Boot集成Loki到Grafana时Logback配置异常求助

一、修复Logback配置文件语法错误 #

1. 解决no applicable action for [Loggers]错误 #

该错误源于Logback配置标签大小写不匹配，Logback要求配置标签必须为小写：

• 错误写法：<Loggers>
• 正确写法：<loggers>

2. 解决AppenderRef相关解析错误 #

检查以下配置细节：

• <appender-ref>标签必须嵌套在<logger>或<root>标签内部，不能直接置于<loggers>节点下
• 标签名必须为小写的<appender-ref>，而非<AppenderRef>
• 确保ref属性值与你定义的Appender的name属性完全一致

示例正确配置片段：

<configuration>
    <!-- 定义Loki Appender -->
    <appender name="LOKI" class="com.github.loki4j.logback.Loki4jAppender">
        <http>
            <url>http://localhost:3100/loki/api/v1/push</url>
        </http>
        <format>
            <pattern>%date{ISO8601} %level [%thread] %logger{36} - %msg</pattern>
        </format>
    </appender>

    <!-- Loggers 配置块 -->
    <loggers>
        <root level="INFO">
            <appender-ref ref="LOKI"/>
            <appender-ref ref="CONSOLE"/>
        </root>
    </loggers>
</configuration>

二、解决NoSuchMethodError: ch.qos.logback.classic.spi.ILoggingEvent.getMarkerList() #

该错误是Loki的logback-appender依赖版本与Spring Boot 2.7.14内置Logback版本不兼容导致的：

• Spring Boot 2.7.14内置的Logback版本为1.2.11
• 新版loki-logback-appender（如1.6.0+）依赖Logback 1.3.x，该版本新增了getMarkerList()方法，与Spring Boot内置版本冲突

解决方案1：使用兼容版本的loki-logback-appender #

选择适配Logback 1.2.11的loki-logback-appender版本，推荐1.5.2，在pom.xml中添加：

<dependency>
    <groupId>com.github.loki4j</groupId>
    <artifactId>loki-logback-appender</artifactId>
    <version>1.5.2</version>
</dependency>

解决方案2：强制统一Logback版本（可选） #

若需使用更高版本的loki-logback-appender，可在pom.xml中强制指定Logback 1.3.x版本（注意需测试Spring Boot兼容性）：

<properties>
    <logback.version>1.3.14</logback.version>
</properties>

三、验证步骤 #

1. 确认Loki服务正常运行，端口3100可访问
2. 检查logback-spring.xml语法合规，标签结构、大小写无误
3. 确认pom.xml依赖版本无冲突
4. 启动应用，验证日志是否正常发送至Loki，再通过Grafana配置Loki数据源查看日志

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