在harmonyos设备上，应用沙箱文件权限管理直接关系到用户数据安全与应用功能能否正常运行，比如微信无法读取相册、备忘录无法保存附件、第三方笔记应用打不开本地pdf——这些异常往往源于沙箱权限配置错误或被系统自动重置。
确认当前应用是否启用沙箱模式
进入【设置】→【应用和服务】→【应用管理】→点击目标应用（如“随手记”）→【权限】→查看顶部是否显示“已启用沙箱存储”。若未显示，说明该应用尚未运行在沙箱环境中，后续权限操作不生效。
注意：仅API 9及以上版本、Target SDK ≥ 10 的应用默认启用沙箱；旧版应用或未适配的应用即使安装在HarmonyOS 4.2+系统中，也不会自动启用沙箱。
手动授予沙箱内特定路径访问权
方法一：通过应用内弹窗授权（推荐）
打开应用→触发需要访问文件的操作（例如点击“导入本地文档”）→系统弹出权限请求框→勾选【允许访问沙箱内所有文件】或【仅本次允许】→点击【确定】。
方法二：手动开启“沙箱文件夹”白名单
进入【设置】→【隐私】→【权限管理】→【文件和媒体】→选择对应应用→开启【沙箱文件夹】开关→点击【添加文件夹】→从列表中选择已创建的沙箱子目录（如Documents/MyNotes/）→确认。
【重要前提】：必须先由应用在沙箱根目录（files/ 或 cache/）下主动创建该子目录，否则列表中不会出现；手动新建的同名文件夹无效。
重置应用沙箱并清除权限记录
第一步：进入【设置】→【应用和服务】→【应用管理】→找到目标应用
第二步：点击右上角⋯→选择【清除数据】→勾选【清除沙箱存储】（此项独立于“清除缓存”和“清除数据”）→点击【确定】
第三步：重启应用，首次启动时会重新触发沙箱初始化流程，系统将按应用声明的requestLegacyExternalStorage属性及targetSDK决定是否恢复旧路径兼容性。
这一步不可逆。清除后，应用内所有沙箱路径下的用户生成文件（如离线地图包、加密笔记缓存）将永久删除，且无法通过系统回收站恢复。
