Xamarin Forms安卓应用共享文件写入出现NULL字符并崩溃问题排查

核心问题点 #

1. 异步操作中错误使用.Result导致阻塞与资源异常 #

在WriteAsync方法里，logFile.OpenAsync(FileAccess.ReadAndWrite).Result直接阻塞线程等待异步操作完成，在持有ReaderWriterLockSlim锁的情况下，会加剧线程阻塞风险，甚至引发死锁。一旦流打开过程中出现异常，被吞掉的异常会导致流资源未正确释放，进而破坏文件结构，产生大量NULL字符。

2. 异常被完全吞灭，无法定位问题根源 #

当前catch块未做任何异常记录或处理，所有写入过程中的错误（如文件权限不足、磁盘空间不足、流操作失败等）都被隐藏，无法得知NULL字符产生的具体触发条件。

3. StreamWriter操作逻辑存在隐患 #

• 未使用await正确等待流打开操作，可能导致流状态不稳定
• 手动Seek到文件末尾的方式，不如直接使用追加模式可靠，若Seek操作失败会导致写入位置错误，甚至覆盖原有内容或写入空字节

4. 无返回值的异步调用导致异常无法被捕获 #

WriteLog方法通过Task.Run触发异步写入，但未返回Task，调用方无法感知写入是否成功。若异步任务抛出未处理异常，会触发UnobservedTaskException，直接导致应用崩溃。

修复步骤 #

1. 修复异步操作，替换.Result为await #

将流打开的同步阻塞改为异步等待，避免线程阻塞与死锁：

using (var stream = await logFile.OpenAsync(FileAccess.ReadAndWrite))
using (StreamWriter streamWriter = new StreamWriter(stream))
{
    streamWriter.BaseStream.Seek(0, SeekOrigin.End);
    streamWriter.WriteLine(string.Format(format, args));
    await streamWriter.FlushAsync();
}

2. 完善异常处理，记录错误信息 #

不要吞掉异常，至少将异常信息输出到Android的Logcat（或临时文件），方便排查：

catch (Exception ex)
{
    // 输出到Logcat，Android环境下可用
    Android.Util.Log.Error("LogWriter", $"写入日志失败: {ex.Message}\n{ex.StackTrace}");
    // 可选：尝试创建新文件重试一次
    try
    {
        logFile = await logFolder.CreateFileAsync(MyFileName, CreationCollisionOption.ReplaceExisting);
        using (var stream = await logFile.OpenAsync(FileAccess.Write))
        using (var writer = new StreamWriter(stream))
        {
            await writer.WriteLineAsync($"[错误恢复] {string.Format(format, args)}");
            await writer.FlushAsync();
        }
    }
    catch (Exception retryEx)
    {
        Android.Util.Log.Error("LogWriter", $"重试写入失败: {retryEx.Message}");
    }
}

3. 优化文件写入逻辑，使用可靠的追加模式 #

PCLStorage的IFile提供了AppendTextAsync方法，可直接追加内容，避免手动Seek的风险：

// 替换原有流操作逻辑
await logFile.AppendTextAsync($"{string.Format(format, args)}{Environment.NewLine}");

4. 修改WriteLog方法为异步，让调用方感知状态 #

将WriteLog改为异步方法，避免未观察到的任务异常：

public async Task WriteLog(string format, params object[] args)
{
    await WriteAsync(format, args);
}

调用方也需改为异步调用：

public async Task WriteToTheSharedFile(string textToWrite)
{
    await myLog.WriteLog("{0:yyyy-MM-dd HH:mm:ss:fff}|{1}", DateTime.Now, "|Information|File");
}

5. 验证ReaderWriterLockSlim的线程安全性 #

确保Log类是单例模式，_logFileLock是静态唯一实例，避免多个锁实例导致并发控制失效。同时，在EnterWriteLock前可增加异常防护，防止锁进入失败：

if (!_logFileLock.TryEnterWriteLock(TimeSpan.FromSeconds(5)))
{
    Android.Util.Log.Warn("LogWriter", "获取写入锁超时，放弃本次日志写入");
    return;
}

排查方法 #

1. 捕获并分析异常日志：通过Logcat查看错误信息，定位触发NULL字符的具体场景（如磁盘空间不足、文件权限变化、文件被系统进程占用等）。
2. 监控文件系统状态：在生产环境中增加磁盘空间、文件权限的监控，排查是否存在系统层面的资源限制。
3. 模拟极端场景测试：在测试环境中模拟磁盘满、文件被锁定等异常情况，复现问题并验证修复效果。
4. 检查流操作的原子性：确保文件写入的整个流程（打开→写入→关闭）是原子操作，避免中途被中断导致文件结构损坏。

内容的提问来源于stack exchange，提问作者J.Doe