如何为基于Spring Cloud Functions的Azure Function App配置Slf4j日志？

一、依赖对齐（避免冲突） #

Azure Functions Java运行时已内置SLF4J绑定，无需额外引入SLF4J实现。如果使用Spring Boot，需排除默认的logback依赖，防止冲突：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-function-adapter-azure</artifactId>
</dependency>

<!-- 若使用Spring Boot，排除logback避免冲突 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
        </exclusion>
    </exclusions>
</dependency>

二、日志文件输出配置 #

Azure会监控/home/LogFiles/Application/目录下的日志文件，需将日志输出到该路径。根据你选择的日志实现，二选一配置：

方案1：使用Logback（推荐） #

在src/main/resources下创建logback.xml：

<configuration>
    <!-- 输出到Azure指定的日志目录 -->
    <appender name="AZURE_FILE" class="ch.qos.logback.core.FileAppender">
        <file>/home/LogFiles/Application/spring-cloud-function.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <!-- 滚动日志配置（可选） -->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>/home/LogFiles/Application/spring-cloud-function.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>10MB</maxFileSize>
            <maxHistory>7</maxHistory>
        </rollingPolicy>
    </appender>

    <!-- 控制台输出（便于本地调试） -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="AZURE_FILE"/>
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

方案2：使用Log4j2 #

在src/main/resources下创建log4j2.xml：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <File name="AZURE_FILE" fileName="/home/LogFiles/Application/spring-cloud-function.log">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"/>
            <!-- 滚动日志配置（可选） -->
            <Policies>
                <SizeBasedTriggeringPolicy size="10MB"/>
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="7"/>
        </File>
        <Console name="CONSOLE" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"/>
        </Console>
    </Appenders>
    <Loggers>
        <Root level="INFO">
            <AppenderRef ref="AZURE_FILE"/>
            <AppenderRef ref="CONSOLE"/>
        </Root>
    </Loggers>
</Configuration>

三、Lombok @Slf4j 正确使用 #

在你的函数类上标注@Slf4j，直接调用日志方法即可：

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import java.util.function.Function;

@Component
@Slf4j
public class MyAzureFunction implements Function<String, String> {

    @Override
    public String apply(String input) {
        log.info("Received input: {}", input);
        String result = "Processed: " + input;
        log.debug("Generated result: {}", result);
        return result;
    }
}

四、Azure门户日志查看配置 #

1. 开启应用日志记录：

   • 进入Azure Function App门户 → 左侧「监测」→「日志流」
   • 开启「应用程序日志记录（文件系统）」，设置日志级别（如INFO），保存配置

2. 查看日志：

   • 在「日志流」页面实时查看输出
   • 通过Kudu工具（访问https://<你的函数应用名>.scm.azurewebsites.net/）进入/home/LogFiles/Application/查看具体日志文件
   • 若配置了存储账户，可在对应存储容器中查看持久化的日志

五、常见问题排查 #

• 依赖冲突：检查是否同时引入logback和log4j2，需仅保留一种日志实现
• 路径错误：必须输出到/home/LogFiles/Application/，Azure仅监控该目录
• 日志级别不匹配：若代码用log.debug()但配置文件root级别为INFO，需调整配置文件的日志级别
• 配置文件未部署：确认部署包中包含logback.xml/log4j2.xml（位于resources目录下）

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