Android｜记一个导致 logback 无法输出日志的问题
内容提要
在给Android项目添加logback日志框架时，遇到无法输出日志到文件的问题。经排查发现是logback无法正确解析变量导致的。原因是在Application类的类初始化过程中调用了LoggerFactory.getLogger()，此时application context还不可用。解决方法是去掉自定义Application类上的@Slf4j注解，改为在onCreate方法中手动初始化logger。
延伸解读
问题根源：初始化时机不当
logback 的特殊属性（如 ${DATA_DIR}）在首次调用 LoggerFactory.getLogger() 时初始化，但必须在 application context 可用之后。如果在 Application 类的类初始化（clinit）过程中调用，此时 context 不可用，变量会解析为空字符串，导致日志文件路径错误。
排查技巧：启用 debug 模式
当 logback 无法输出日志时，可在 logback.xml 的 <configuration> 根元素添加 debug="true" 属性，重启应用后查看 logcat 输出。这样能快速定位配置解析错误，例如本例中日志路径被错误解析为 /log/app.log。
避免过早初始化：慎用 @Slf4j
@Slf4j 注解会生成静态 logger 字段，其初始化会调用 LoggerFactory.getLogger()。若在 Application 类及其基类上使用，会导致 logger 在类初始化时过早创建，此时 context 尚未就绪。应移除这些注解，改为在 onCreate 中手动初始化 logger。
经验教训：重视官方文档
logback-android 的 wiki 明确说明了特殊属性的初始化时机，但容易被忽略。集成第三方库时，仔细阅读文档能避免许多隐蔽问题，本例再次印证了这一点。
Q&A
在Android项目中使用logback时遇到什么问题？
在Android项目中集成logback日志框架时，无法输出日志到文件。
为什么logback无法解析${DATA_DIR}变量？
因为在Application类的类初始化过程中调用了LoggerFactory.getLogger()，此时application context还不可用。
如何解决logback无法输出日志的问题？
去掉自定义Application类上的@Slf4j注解，在onCreate方法中手动初始化logger。
使用@Slf4j注解会导致什么问题？
使用@Slf4j注解会导致logger过早初始化，从而在application context不可用时调用LoggerFactory.getLogger()。
如何检查logback的配置问题？
可以通过开启logback的debug模式，查看logcat输出，检查日志文件路径和错误信息。
在使用logback时，为什么要在onCreate方法中初始化logger？
因为logback的特殊属性在第一次调用LoggerFactory.getLogger()时初始化，必须在application context可用后进行。
