Flutter应用经Jenkins构建后日志无法写入指定文件的问题求助

可能原因 #

1. Release模式下PrettyPrinter的颜色输出干扰
   debug模式下控制台支持ANSI颜色码，但release模式下，PrettyPrinter输出的带颜色标记的日志内容，可能导致FileOutput无法正确解析或写入，进而中断日志输出。

2. Logger包在Release模式下的日志级别被覆盖
   尽管代码中设置了Level.all，但release模式下的编译优化（如R8/ProGuard混淆）可能会修改Logger的内部逻辑，导致实际生效的日志级别低于预期。

3. FileOutput的内部实现在Release模式下存在兼容性问题
   logger包的FileOutput在debug和release模式下的行为可能不一致，比如异步写入的处理逻辑差异，导致release模式下无法正常写入日志。

解决步骤 #

1. 禁用Release模式下的日志颜色输出

使用Flutter的kReleaseMode常量判断环境，仅在debug模式启用颜色：

import 'package:flutter/foundation.dart';

final Logger myLogger = Logger(
  level: Level.all,
  printer: PrettyPrinter(
    dateTimeFormat: DateTimeFormat.dateAndTime,
    colors: !kReleaseMode, // 仅debug模式显示颜色
  ),
  output: MultiOutput(
    [
      ConsoleOutput(),
      FileOutput(file: logFile),
    ],
  ),
);

2. 添加Logger包的混淆规则（Android端）

如果你的Android构建启用了R8/ProGuard，需在android/app/proguard-rules.pro中添加以下规则，避免Logger底层依赖被混淆：

-keep class com.github.tony19.logback.android.** { *; }
-keep class ch.qos.logback.** { *; }
-keep class org.slf4j.** { *; }

3. 自定义文件输出类替代FileOutput

手动实现日志文件写入逻辑，避免依赖logger包的FileOutput：

import 'dart:io';
import 'package:logger/logger.dart';

class CustomFileOutput extends LogOutput {
  final File file;
  IOSink? _sink;

  CustomFileOutput({required this.file});

  @override
  void init() {
    _sink = file.openWrite(mode: FileMode.append);
  }

  @override
  void output(OutputEvent event) {
    _sink?.writeAll(event.lines, '\n');
    _sink?.write('\n');
    _sink?.flush();
  }

  @override
  void dispose() {
    _sink?.close();
  }
}

然后替换原有的FileOutput：

output: MultiOutput(
  [
    ConsoleOutput(),
    CustomFileOutput(file: logFile), // 使用自定义输出
  ],
),

4. 验证文件写入权限

在release模式下，手动测试文件写入是否正常，排除权限异常：

// 在Logger初始化后添加测试代码
await logFile.writeAsString('Test release log\n', mode: FileMode.append);

如果测试内容能写入，说明权限没问题，问题出在Logger的输出逻辑上。

内容的提问来源于stack exchange，提问作者Luiz Fiuza