游戏客户端架构 / 系统课时

权限不足时怎么定位根因

权限不足时怎么定位根因

保存失败出现 UnauthorizedAccessException 或“permission denied”时,真正原因不一定只是权限开关。路径不存在、写到了只读目录、沙盒越界、把文件当目录以及路径拼接错误都可能表现成写入失败。本节用固定排查顺序把问题缩小到可验证的根因。

学习目标

  • 按目录、路径、沙盒和实际写权限的顺序定位保存失败
  • 用最小写入测试区分序列化问题与文件系统问题
  • 根据异常类型选择修复方案并验证结果

先确认最终写到了哪里

排查权限问题时,第一步不是立刻申请更多权限,而是打印最终解析后的绝对路径。开发环境和正式包的工作目录、应用目录往往不同,只看代码里的相对路径无法确认实际写入位置。

同时检查路径代表的是文件还是目录。例如目标本应是 <PATH>/saves/slot-01.json,却提前把整个字符串传给 Directory.CreateDirectory,最终会创建一个名为 slot-01.json 的目录,后续文件写入自然失败。

按固定顺序逐层排查

权限类故障适合从最便宜、最确定的检查开始,而不是随机修改系统设置。

存档写入失败的权限排查流程

建议依次确认:

  1. 打印最终绝对路径,确认没有意外写到安装目录、资源目录或其他用户目录。
  2. 检查父目录是否存在,并尝试显式创建。
  3. 确认根目录来自平台允许的持久化应用目录,而不是手写绝对路径。
  4. 在目标目录执行一次“创建临时文件 → 写入 → 读取 → 删除”的最小测试。
  5. 如果最小测试成功,再回到正式存档流程检查文件占用、替换策略、序列化和并发写入。

这个顺序的关键价值是:先证明文件系统本身能写,再研究更高层的业务逻辑。

用最小探针验证真实写权限

下面的 Unity C# 示例不写正式存档,只在目标目录创建一个探针文件。它同时区分未授权、路径错误和其他 I/O 异常,适合直接挂到测试场景中运行。

csharp
using System;
using System.IO;
using UnityEngine;

public sealed class SavePermissionProbe : MonoBehaviour
{
    private void Start()
    {
        string directory = Path.Combine(Application.persistentDataPath, "saves");
        string probePath = Path.Combine(directory, ".write-probe.tmp");

        try
        {
            Directory.CreateDirectory(directory);

            // 只验证最基础的创建、写入、读取和删除能力。
            File.WriteAllText(probePath, "ok");
            string value = File.ReadAllText(probePath);
            File.Delete(probePath);

            Debug.Log($"Write probe succeeded: {value}, path={directory}");
        }
        catch (UnauthorizedAccessException ex)
        {
            Debug.LogError($"Write permission denied: {ex.Message}");
        }
        catch (DirectoryNotFoundException ex)
        {
            Debug.LogError($"Directory invalid: {ex.Message}");
        }
        catch (IOException ex)
        {
            Debug.LogError($"I/O failure: {ex.Message}");
        }
    }
}

目录可正常写入时,预期输出为:

text
Write probe succeeded: ok, path=<PATH>

如果进入异常分支,不要依赖异常文本做跨平台程序逻辑判断,因为不同系统和运行时的消息可能不同;应以异常类型、目标路径以及平台规则共同定位原因。

常见根因怎么区分

路径本身不对时,日志通常会暴露出安装目录、资源目录、空路径或重复拼接的层级。修复方式是回到统一的路径提供器,而不是给错误目录追加权限。

沙盒越界时,移动端尤其常见。应用通常只能直接写自己的容器目录,不能把桌面系统上的任意路径思维照搬过去。正式存档应放到平台提供的持久化应用目录;只有产品确实需要访问用户选择的外部文件时,才接入对应平台的文件选择或授权机制。

目录和文件冲突时,可以出现“看起来存在,但就是写不了”的现象。例如 slot-01.json 已经被错误创建成目录,或者目标文件被标记为只读。此时继续重试没有意义,应先检查文件系统对象类型和属性。

主机存档规则未满足时,也不能简单归类为文件权限。部分平台要求先打开或挂载用户存档空间,再写入并提交;具体流程必须走目标平台官方 SDK 或引擎提供的主机接口,不能通过猜测目录绕过。

修复后要验证完整写入周期

最小探针成功只能证明目录基础写权限正常。正式修复还应验证创建新存档、覆盖已有存档、读取、删除或轮换备份,并在应用重启后再次读取一次。

如果基础探针失败,就继续解决平台路径和权限;如果基础探针成功而正式保存仍失败,排查重点应立即上移到文件占用、并发写入、临时文件替换和序列化流程。把这条边界划清,权限问题通常就不会演变成无方向的反复试错。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

权限不足时怎么定位根因

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通