Cordova App创建内部存储目录失败求助：代码无法正常运行

我太懂这种明明照着通用方案写代码却死活不生效的憋屈了！别着急，咱们一步步排查坑点，再给你补全能跑通的完整方案。

先揪出你现有代码的潜在问题 #

你贴的代码片段有截断，但从常见的Cordova存储坑来看，大概率是这几个原因：

• 权限没到位：Cordova读写存储必须明确申请权限，缺了这个啥操作都白搭
• 错误处理缺失：你没写失败回调，根本不知道是获取文件系统失败，还是创建文件夹时出了错
• 路径理解偏差：LocalFileSystem.PERSISTENT对应的是App私有存储路径，如果你想在公共内部存储（比如手机根目录）建文件夹，这个路径就不对

修复后的完整可运行代码 #

先给你补全权限处理、错误回调的完整代码：

document.addEventListener('deviceready', onDeviceReady, false);

function onDeviceReady() {
    // 先搞定存储权限，没权限一切免谈
    getStoragePermission().then(() => {
        const new_directory = 'TEST';
        window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, 
            // 获取文件系统成功的回调
            function(fileSystem) {
                fileSystem.root.getDirectory(new_directory, { create: true, exclusive: false }, 
                    // 文件夹创建成功
                    function(dirEntry) {
                        alert(`文件夹创建成功！路径：${dirEntry.fullPath}`);
                        // 这里可以继续写图片存储的逻辑
                    }, 
                    // 创建文件夹失败的错误回调
                    function(error) {
                        alert(`创建文件夹失败：${error.code}`);
                        showErrorDetail(error);
                    }
                );
            }, 
            // 获取文件系统失败的错误回调
            function(error) {
                alert(`获取文件系统失败：${error.code}`);
                showErrorDetail(error);
            }
        );
    }).catch((err) => {
        alert(`权限申请被拒：${err}`);
    });
}

// 检查并请求存储权限
function getStoragePermission() {
    return new Promise((resolve, reject) => {
        const permissions = cordova.plugins.permissions;
        permissions.checkPermission(permissions.WRITE_EXTERNAL_STORAGE, (status) => {
            if (status.hasPermission) {
                resolve();
            } else {
                permissions.requestPermission(permissions.WRITE_EXTERNAL_STORAGE, () => {
                    resolve();
                }, () => {
                    reject('用户拒绝了存储权限');
                });
            }
        }, () => {
            reject('权限检查出错');
        });
    });
}

// 打印详细错误信息，方便排查
function showErrorDetail(error) {
    switch(error.code) {
        case FileError.SECURITY_ERR:
            console.log("安全权限错误：可能没申请权限");
            break;
        case FileError.PATH_EXISTS_ERR:
            console.log("路径已存在：文件夹已经创建过了");
            break;
        case FileError.NOT_FOUND_ERR:
            console.log("未找到指定父路径");
            break;
        case FileError.NO_MODIFICATION_ALLOWED_ERR:
            console.log("不允许修改该路径");
            break;
        default:
            console.log(`未知错误码：${error.code}`);
    }
}

必须做的前置准备 #

• 安装核心插件：确保你已经装了这两个插件，没装的话执行命令：

  cordova plugin add cordova-plugin-file
  cordova plugin add cordova-plugin-permissions
  

• Android 10+ 适配：如果你的目标设备是Android 10及以上，需要在config.xml里添加兼容旧存储模式的配置，避免Scoped Storage限制：

  <platform name="android">
      <config-file parent="/manifest/application" target="AndroidManifest.xml">
          <application android:requestLegacyExternalStorage="true" />
      </config-file>
  </platform>
  

如果你想在公共内部存储建文件夹 #

上面的代码是在App私有存储创建文件夹，如果想在手机公共内部存储（比如根目录、Pictures文件夹）创建，需要改用cordova.file.externalRootDirectory，修改代码片段如下：

// 替换requestFileSystem的部分，直接解析公共存储路径
window.resolveLocalFileSystemURL(cordova.file.externalRootDirectory, function(rootDir) {
    rootDir.getDirectory(new_directory, { create: true, exclusive: false }, 
        function(newDir) {
            alert(`公共存储文件夹创建成功：${newDir.fullPath}`);
        }, 
        showErrorDetail
    );
}, showErrorDetail);

调试小技巧 #

• 用console.log打印完整路径，确认你操作的是预期的存储位置
• 查看Android设备的Logcat日志，能找到更详细的系统级错误信息，帮你精准定位问题

内容的提问来源于stack exchange，提问作者Aakash Bhadana