Android系统如何重命名PDF文件 相关代码运行始终报错怎么办

现有代码核心问题 #

• 逻辑判断错误：if条件使用了||（或运算符），实际需要的是&&（与运算符），要求同时满足「新名称不为空」「新名称与原名称不一致」两个条件才触发重命名，当前逻辑会出现新名称为空时依然执行重命名的问题，必然报错。
• 目标文件路径缺失：创建新File对象时仅传入了文件名，没有携带原文件的父路径，相当于尝试跨目录移动重命名文件，绝大多数场景下会执行失败。
• 后缀重复风险：直接给新名称拼接.pdf后缀，如果用户输入的新名称本身已经携带.pdf后缀，会生成xxx.pdf.pdf的错误文件名。
• 权限适配缺失：Android 6.0及以上版本操作外部存储文件需要动态申请存储权限，Android 10及以上版本采用分区存储机制，公共目录下的文件直接使用File.renameTo接口会被系统拦截。

修复后的基础代码示例 #

String renamed = "New Name";
File file = pdfFiles.get(position);
// 先处理后缀，避免重复
String newFileName = renamed.endsWith(".pdf") ? renamed : renamed + ".pdf";
// 条件改为与逻辑，同时要判断新名称是否和原名称一致
if (!renamed.isEmpty() && !newFileName.equals(file.getName())) {
    // 构造完整的目标文件路径，和原文件同目录
    File targetFile = new File(file.getParentFile(), newFileName);
    boolean success = file.renameTo(targetFile);
    if (success) {
        // 重命名成功后记得刷新pdfFiles列表数据，不然列表显示的还是旧名称
        pdfFiles.set(position, targetFile);
        // 可补充列表适配器刷新代码，如adapter.notifyDataSetChanged();
        Toast.makeText(context, "重命名成功", Toast.LENGTH_SHORT).show();
    } else {
        Toast.makeText(context, "重命名失败，请检查存储权限或文件是否被占用", Toast.LENGTH_SHORT).show();
    }
}

额外适配说明 #

• Android 6.0（API 23）到Android 9（API 28）：需要先动态申请WRITE_EXTERNAL_STORAGE权限，权限申请通过后再执行重命名逻辑。
• Android 10（API 29）及以上：如果操作的是公共下载、文档目录下的PDF文件，不要直接使用File API，改用MediaStore API更新文件的显示名称，避免权限拦截。

内容的提问来源于stack exchange，提问作者Syed Irfan Hussaini