uni-app无法直接监听“存储空间不足”事件，仅Android端可通过原生StatFs估算/data分区剩余空间并阈值提醒，iOS和H5不可行；需条件编译，调用getPath()获取路径，用getBlockSize()和getAvailableBlocks()计算字节数，建议100MB以下提示、50MB以下限制写入。
uni-app 无法直接监听“存储空间不足”系统级事件，也没有跨端 API 能主动触发该提醒；你只能在 Android 端通过原生桥接估算可用空间，并手动判断阈值后弹窗提示，iOS 端完全不可行。
Android 端用 StatFs 判断内部存储是否快满
这是目前唯一可落地的方案，但注意它返回的是应用数据目录所在分区（通常是 /data）的剩余空间，不是整个机身存储（如 /sdcard），不过对“App 是否还能写缓存/下载文件”这个场景足够有效。
- 必须加条件编译：
#ifdef APP-PLUS && #ifdef ANDROID，iOS 和 H5 直接跳过 - 关键路径提取不能漏：
plus.android.invoke(file, 'getPath')，否则StatFs构造失败 - 别用
getBlockSizeLong()或getAvailableBlocksLong()—— HBuilderX 旧版 runtime 不支持 long 方法，只用无后缀版 - 计算单位要对：Android Q+ 后
getBlockSize()返回逻辑块大小（通常 4096 字节），直接乘getAvailableBlocks()得字节数 - 阈值建议设为 100MB 以下才提醒，避免频繁误报；低于 50MB 可强制限制新文件写入
const Environment = plus.android.importClass('android.os.Environment');
const StatFs = plus.android.importClass('android.os.StatFs');
const dataDir = Environment.getDataDirectory();
const path = plus.android.invoke(dataDir, 'getPath');
const stat = new StatFs(path);
const blockSize = plus.android.invoke(stat, 'getBlockSize');
const availBlocks = plus.android.invoke(stat, 'getAvailableBlocks');
const bytes = blockSize * availBlocks;
if (bytes < 100 * 1024 * 1024) {
uni.showToast({ title: '存储空间紧张', icon: 'none' });
}
iOS 端为什么做不到存储不足提醒
iOS 系统从底层禁止第三方 App 访问磁盘总容量、剩余空间等信息，这不是 uni-app 的限制，而是 App Store 审核强制要求。你看到的“设置 → 通用 → iPhone 存储空间”是系统私有框架渲染的，App 进程无权读取任何对应路径或 API。
- 所有声称“纯 JS 获取 iOS 剩余空间”的方案，要么伪造固定数值，要么依赖越狱环境
-
plus.ios没有等效于 AndroidStatFs的类，NSFileManager的attributesOfFileSystemForPath在 App Sandbox 下只返回沙盒内路径（如Documents），而该路径大小不反映整机状态 - 即使你绕过限制拿到沙盒可用空间，它也和用户感知的“手机快满了”毫无关系——用户清理的是照片、微信缓存、系统更新包，不是你的
Documents目录
uni.getFileSystemManager().getAvailableStorage() 的真实能力
这个 API 看起来像能解决问题，但它在不同平台行为差异极大，且返回值不稳定：
- Android 上它调用的是
Environment.getExternalStorageDirectory().getUsableSpace()，即外置 SD 卡（或模拟 SD 卡路径），但多数新机型已无物理 SD 卡，该路径实际指向/sdcard，和系统剩余空间仍不一致 - iOS 上它返回的是沙盒内
tmp目录的可用空间，数值极小（常几 MB），且会随系统清理自动变化，完全不可靠 - H5 端该 API 不可用，调用直接报错
undefined is not a function - 它不提供回调监听，也不能注册“空间不足”事件，只能手动轮询调用，但频繁调用影响性能且无意义
真正需要“存储不足提醒”的场景，比如大文件下载前校验、缓存策略降级、用户清理引导，核心不是获取精确数字，而是建立稳定 fallback：Android 做空间估算 + 提示，iOS 改用轻量策略（如禁用大图缓存、压缩上传、默认走云端临时存储），并把提示文案从“手机空间不足”改成更准确的“本地缓存受限，部分功能将使用在线模式”。
