Serilog在MAUI项目中日志文件未生成的解决方案

问题背景

在使用MAUI框架开发移动应用时，开发者经常需要记录应用运行日志以便后续分析和调试。Serilog作为.NET生态中流行的结构化日志记录库，因其灵活的配置和强大的功能而广受欢迎。然而，在MAUI项目中集成Serilog时，开发者可能会遇到日志文件看似未生成的问题。

核心问题分析

当开发者在MAUI项目中使用Serilog的File Sink配置日志记录时，可能会发现虽然日志目录成功创建，但预期的日志文件却不存在。这种情况通常是由于对Serilog的文件滚动机制理解不足导致的。

详细技术解析

文件滚动机制

Serilog的File Sink提供了强大的日志文件滚动功能，通过rollingInterval参数可以配置按时间间隔自动创建新的日志文件。当设置rollingInterval: RollingInterval.Day时，Serilog会自动按天分割日志文件，文件名会附加当前日期，格式为logyyyyMMdd.txt。

MAUI中的文件路径

在MAUI项目中，应用数据目录的路径结构如下：

/data/user/0/com.companyname.appname/files/

日志文件默认会被存储在该目录下的logs子文件夹中。

解决方案

方案一：禁用文件滚动

如果不需要按日期分割日志文件，可以简化配置，移除rollingInterval参数：

Log.Logger = new LoggerConfiguration()
    .WriteTo.File(
        path: Path.Combine(logDirectory, "log.txt"),
        retainedFileCountLimit: 7,
        restrictedToMinimumLevel: Serilog.Events.LogEventLevel.Information
    )
    .CreateLogger();

这样配置后，日志将始终写入固定的log.txt文件中。

方案二：正确处理滚动文件名

如果需要保留按日期分割日志的功能，在读取日志文件时需要动态构建包含日期的文件名：

var logFilePath = Path.Combine(
    FileSystem.Current.AppDataDirectory, 
    "logs", 
    $"log{DateTime.Now:yyyyMMdd}.txt"
);

日志文件管理

通过retainedFileCountLimit参数可以控制保留的日志文件数量，Serilog会自动清理过期的日志文件，避免存储空间被无限占用。

最佳实践建议

1. 开发阶段验证：在应用启动后立即检查日志文件是否生成，确认配置正确
2. 日志级别设置：根据实际需求设置适当的日志级别，平衡详细程度和性能
3. 异常处理：在日志文件操作周围添加适当的异常处理，应对权限等问题
4. 定期清理：合理配置retainedFileCountLimit，避免日志文件过多占用存储空间

总结

理解Serilog的文件滚动机制是解决此类问题的关键。在MAUI项目中使用Serilog时，开发者需要特别注意文件名的动态变化特性。通过合理配置和正确的文件访问方式，可以确保日志记录功能正常工作，为应用维护和故障排查提供可靠支持。