log4j控制台日志正常但file appender报错无输出流无法写日志如何解决

报错本质 #

出现log4j:ERROR No output stream or file set for the appender named [file]的核心逻辑是：Log4j 初始化file类型的文件输出appender时，未匹配到对应的绑定输出文件/流配置，导致appender无法正常完成初始化，无法写入日志文件。

具体问题点与修复方案 #

• 配置项大小写不匹配（直接触发报错的核心原因）
  Log4j 1.x 对配置项大小写严格敏感：你在log4j.rootLogger中声明使用名为file的appender，但设置文件路径时，错把配置前缀写为大写FILE，对应无效配置行：log4j.appender.FILE.File=${log}/logger.log。该配置对名为file的appender完全不生效，导致file appender未绑定任何输出文件，直接触发报错。
  修复方式：将大写FILE改为与appender名完全一致的小写file，调整为：log4j.appender.file.File=${log}/logger.log

• 日志输出路径配置不可用
  你定义的log=/src/main/resources是项目编译前的源码相对路径，项目打包运行后该路径在文件系统中实际不存在，即便修复大小写问题，也会因目录不存在、无写入权限导致日志无法落盘。
  修复方式：将日志路径替换为运行时可正常访问的合法路径，比如相对程序工作目录的log=./logs（程序运行时会在工作目录下自动生成logs目录存储日志），或基于系统属性定义的绝对路径log=${user.home}/app/logs。

• 配置文件加载逻辑失效
  测试类中硬编码的配置加载路径PropertyConfigurator.configure("/src/main/resources/log4j.properties")为绝对路径，绝大多数运行环境下都无法匹配到实际的配置文件——当前控制台能正常打印日志，是IDE自动加载了classpath下的配置文件，并非代码中该加载逻辑生效。
  修复方式：改用类加载器读取classpath路径下的配置文件，将加载代码调整为：

  PropertyConfigurator.configure(Test.class.getResource("/log4j.properties"));
  

• 配置格式不规范
  部分appender配置行开头存在多余前导空格，虽不影响Log4j识别，但容易在后续维护时引发拼写、大小写匹配错误，建议统一移除行首多余空格，保持配置格式对齐。

验证方式 #

按上述调整完成后重新运行测试类，Log4j会自动在指定的日志目录下生成logger.log文件，控制台日志打印逻辑不受影响。

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