1. 为什么需要多环境日志配置

刚接手一个新项目时，我经常遇到这样的场景：本地开发时想看DEBUG日志排查问题，但生产环境又怕日志量太大影响性能。更头疼的是测试同学总抱怨测试环境的日志找不到，而运维同事则要求生产日志必须按天归档压缩。这就是典型的多环境日志管理需求——不同环境需要不同的日志策略。

举个例子，我们团队曾有个服务在生产环境突然CPU飙高，但因为怕影响性能不敢开DEBUG日志，最后只能靠猜来定位问题，花了整整两天。后来我们设计了一套环境自适应的日志方案，开发时自动开启详细日志，上线后自动切换为精简模式，从此再没为日志问题加过班。

2. 基础环境隔离方案

2.1 Spring Profile的妙用

Spring Profile是我最推荐的环境隔离方案。假设我们有个电商项目，可以这样组织配置文件：

<!-- logback-spring.xml -->
<springProfile name="dev">
    <root level="DEBUG">
        <appender-ref ref="CONSOLE"/>
    </root>
</springProfile>

<springProfile name="prod">
    <root level="INFO">
        <appender-ref ref="FILE"/>
        <appender-ref ref="ERROR_MAIL"/>
    </root>
</springProfile>

配套的application.yml配置：

spring:
  profiles:
    active: @activatedProperties@  # Maven过滤不同环境的配置

实际使用时，通过启动参数指定环境：

java -jar app.jar --spring.profiles.active=prod

2.2 环境变量动态注入

对于容器化部署的场景，环境变量更灵活。比如在K8S的Deployment中：

env:
- name: LOG_LEVEL
  valueFrom:
    configMapKeyRef:
      name: env-config
      key: log.level

然后在logback配置中引用：

<variable name="LOG_LEVEL" value="${LOG_LEVEL:-INFO}"/>
<root level="${LOG_LEVEL}">
    ...
</root>

3. 高级配置技巧

3.1 日志输出差异化

不同环境需要的日志格式也不同。这是我们团队使用的模板：

<springProfile name="dev">
    <pattern>%cyan(%d{HH:mm:ss}) %highlight(%-5level) %magenta([%thread]) %yellow(%logger{36}) - %msg%n</pattern>
</springProfile>

<springProfile name="prod">
    <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} %X{traceId} - %msg%n</pattern>
</springProfile>

生产环境增加了traceId方便链路追踪，而开发环境用彩色输出提升可读性。

3.2 存储策略配置

对于日志文件管理，我推荐这种组合策略：

<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
    <!-- 生产环境保留30天日志，测试环境保留7天 -->
    <maxHistory>${LOG_MAX_HISTORY:-7}</maxHistory>
    <!-- 单个文件不超过100MB -->
    <maxFileSize>${LOG_MAX_SIZE:-100MB}</maxFileSize>
    <!-- 总大小不超过5GB -->
    <totalSizeCap>${LOG_TOTAL_CAP:-5GB}</totalSizeCap>
    <fileNamePattern>logs/app-%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
</rollingPolicy>

4. 完整配置模板

下面是我在多个生产项目中验证过的配置模板：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 公共属性 -->
    <property name="LOG_DIR" value="${LOG_PATH:-./logs}"/>
    <property name="APP_NAME" value="${spring.application.name:-application}"/>
    
    <!-- 开发环境控制台输出 -->
    <springProfile name="dev | test">
        <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
            <encoder>
                <pattern>%d{HH:mm:ss.SSS} %highlight(%-5level) %cyan([%thread]) %yellow(%logger{36}) - %msg%n</pattern>
            </encoder>
        </appender>
    </springProfile>

    <!-- 生产环境文件输出 -->
    <springProfile name="prod">
        <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
            <file>${LOG_DIR}/${APP_NAME}.log</file>
            <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
                <fileNamePattern>${LOG_DIR}/${APP_NAME}-%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
                <maxHistory>30</maxHistory>
                <maxFileSize>100MB</maxFileSize>
                <totalSizeCap>5GB</totalSizeCap>
            </rollingPolicy>
            <encoder>
                <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} %X{traceId} - %msg%n</pattern>
            </encoder>
        </appender>
    </springProfile>

    <!-- 错误邮件通知（仅生产环境） -->
    <springProfile name="prod">
        <appender name="ERROR_MAIL" class="ch.qos.logback.classic.net.SMTPAppender">
            <smtpHost>smtp.example.com</smtpHost>
            <to>ops@example.com</to>
            <from>noreply@example.com</from>
            <subject>${APP_NAME} ERROR</subject>
            <layout class="ch.qos.logback.classic.PatternLayout">
                <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger - %msg%n</pattern>
            </layout>
            <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
                <level>ERROR</level>
            </filter>
        </appender>
    </springProfile>

    <!-- 动态日志级别 -->
    <root level="${LOG_LEVEL:-INFO}">
        <springProfile name="dev">
            <appender-ref ref="CONSOLE"/>
        </springProfile>
        <springProfile name="prod">
            <appender-ref ref="FILE"/>
            <appender-ref ref="ERROR_MAIL"/>
        </springProfile>
    </root>
</configuration>

5. 常见问题解决方案

5.1 配置不生效排查

遇到过几次配置不生效的情况，总结出这个检查清单：

1. 确认文件名是logback-spring.xml而非logback.xml
2. 检查spring.profiles.active参数是否正确传递
3. 查看启动日志中有无"Loaded config from..."提示
4. 尝试开启logback内部日志：

5.2 性能优化建议

在高并发场景下，这些优化很关键：

<!-- 异步日志提升性能 -->
<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
    <queueSize>1024</queueSize>
    <discardingThreshold>0</discardingThreshold>
    <appender-ref ref="FILE"/>
</appender>

<!-- 生产环境关闭不必要的日志 -->
<logger name="org.hibernate" level="WARN"/>
<logger name="org.springframework" level="INFO"/>

6. 进阶：与监控系统集成

现代系统还需要将日志对接ELK等监控系统。这是我们正在使用的方案：

<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <destination>logstash.example.com:5000</destination>
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <customFields>{"app":"${APP_NAME}","env":"${spring.profiles.active}"}</customFields>
    </encoder>
</appender>

配合logstash的grok过滤规则：

filter {
    grok {
        match => { "message" => "%{TIMESTAMP_ISO8601:timestamp} \[%{DATA:thread}\] %{LOGLEVEL:level} %{DATA:logger} %{DATA:traceId} - %{GREEDYDATA:msg}" }
    }
}

这套配置让我们的平均故障定位时间从2小时缩短到15分钟。当系统出现异常时，运维团队可以直接在Kibana上通过traceId快速关联相关日志。