在 Java 開發(fā)中，日志打印是一個老生常談的話題。我們常常會遇到這樣的困惑：

“加太多日志會影響系統(tǒng)性能，但加少了又怕線上出問題查不到原因。”

那么，我們到底該不該加日志？如果加，又該如何優(yōu)雅地控制生產(chǎn)環(huán)境的日志輸出？

一、為什么日志如此重要？

日志是排查問題的重要依據(jù)，尤其在生產(chǎn)環(huán)境中，它是我們了解系統(tǒng)運行狀態(tài)的唯一窗口。沒有日志，系統(tǒng)就像一個“黑盒子”，一旦出現(xiàn)問題，排查起來非常困難。

日志的主要作用包括：

• 記錄程序運行狀態(tài)
• 跟蹤業(yè)務(wù)流程
• 捕獲異常信息
• 支持審計與監(jiān)控
• 提供性能分析依據(jù)

所以，日志不是要不要加的問題，而是要加得合理、加得可控。

二、日志帶來的性能影響

雖然日志重要，但確實也存在性能開銷，尤其是在高并發(fā)場景下。以下是常見的性能影響因素：

因此，日志不是越多越好，而是要“按需輸出”。特別是在生產(chǎn)環(huán)境中，我們應(yīng)該盡量避免輸出 DEBUG、TRACE 等低級別日志。

三、如何優(yōu)雅控制日志輸出？

我們可以通過以下幾種方式來實現(xiàn)日志的“按需輸出”：

1. 使用日志級別控制

Java 中常用的日志框架（如 Logback、Log4j2）都支持日志級別控制。常見的日志級別包括：

• ERROR：嚴重錯誤
• WARN：警告信息
• INFO：關(guān)鍵流程信息
• DEBUG：調(diào)試信息
• TRACE：更詳細的調(diào)試信息

在生產(chǎn)環(huán)境中，建議將全局日志級別設(shè)置為 INFO 或 WARN，只在需要排查問題時臨時調(diào)整為 DEBUG 或 TRACE。

示例：Logback 配置示例

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

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

2. 使用動態(tài)日志級別調(diào)整

很多現(xiàn)代日志框架支持在運行時動態(tài)調(diào)整日志級別，無需重啟應(yīng)用。例如：

• Spring Boot Actuator 提供了 /actuator/loggers 接口，可以查看和修改日志級別。
• Logback 的 JMX 支持：可以通過 JMX 客戶端動態(tài)修改日志配置。
• Arthas：阿里巴巴開源的 Java 診斷工具，支持運行時修改日志級別。

示例：使用 Arthas 修改日志級別

# 查看當前日志級別
logger

# 修改某個包的日志級別
logger --name com.example.service --level debug

3. 使用條件日志輸出

在代碼中使用 if (log.isDebugEnabled()) 等判斷，避免不必要的字符串拼接和日志輸出。

if (log.isDebugEnabled()) {
    log.debug("Processing user: {}", user);
}

這樣可以避免在非調(diào)試模式下執(zhí)行字符串拼接等操作，提升性能。

4. 使用日志采樣機制

對于高頻調(diào)用的方法，可以采用日志采樣的方式，比如每 100 次調(diào)用記錄一次日志，既能保留信息，又不至于影響性能。

if (counter.incrementAndGet() % 100 == 0) {
    log.info("Sampled log at count: {}", counter.get());
}

5. 使用 AOP 實現(xiàn)日志開關(guān)控制

可以借助 Spring AOP，在切面中控制日志是否輸出。比如通過一個開關(guān)配置項，決定是否記錄某些關(guān)鍵日志。

@Aspect
@Component
publicclass LoggingAspect {

    privatestaticfinal Logger log = LoggerFactory.getLogger(LoggingAspect.class);

    @Value("${enable.debug.logging:false}")
    privateboolean enableDebugLogging;

    @AfterReturning("execution(* com.example.service.*.*(..))")
    public void logServiceCall(JoinPoint joinPoint) {
        if (enableDebugLogging) {
            log.debug("Called method: {}", joinPoint.getSignature().getName());
        }
    }
}

四、推薦的最佳實踐

五、總結(jié)

日志不是要不要加的問題，而是要加得合理、加得可控。在生產(chǎn)環(huán)境中，我們需要做到：

• 日志級別分明：ERROR/WARN/INFO/DEBUG/TRACE 各司其職；
• 動態(tài)調(diào)整能力：支持運行時修改日志級別，便于問題排查；
• 性能兼顧：避免不必要的日志輸出，提升系統(tǒng)性能；
• 按需采樣：高頻方法中使用采樣機制；
• AOP 控制：通過配置開關(guān)控制日志輸出。

這樣，我們就能在不影響系統(tǒng)性能的前提下，確保在需要時能拿到關(guān)鍵日志信息，做到“需要時有日志，不需要時不打日志”。