Android导出LinearLayout为图片，删除已存同名文件后再次保存时Uri返回null的问题

• 核心触发逻辑来自Android 10（API 29）引入的**分区存储（Scoped Storage）**强校验规则：
  • 你在系统文件管理器手动删除已保存的图片时，系统不会立刻物理清除该图片对应的MediaStore数据库条目，只会先给条目打上软删除标记，等系统媒体扫描器在设备闲时异步完成物理清理。
  • 当你再次调用MediaStore.insert()创建和软删除条目完全匹配的RELATIVE_PATH、DISPLAY_NAME的新条目时，系统为了避免新旧数据冲突，会直接返回null的插入结果，不会生成可写入的Uri。整个过程不会抛出显式异常，仅在Logcat输出Warn级别日志，所以你之前很难定位到问题。
• 你现有代码的设计缺陷会放大这个问题：
  • 存图的文件名完全固定为nombrePersonaje + ".jpg"，没有做任何重名兼容或唯一化处理，完全依赖系统自动处理重名场景，极易触发上述的软删除条目拦截逻辑。
  • 你遇到的“首次启动存图成功、重启应用后存图失败、手动删除旧图后存图必失败”的表现，完全和这个校验逻辑对应：首次启动时没有任何同名残留条目可以触发拦截；重启应用后之前删除的图片对应的软删除标记还没被系统异步清理；手动删除旧图时软删除标记会立刻打上，所以每次删完必触发拦截。

• 主动清理残留的同名软删除条目
  在调用insert方法前，先通过MediaStore查询目标路径下是否存在同名的旧条目，存在则主动删除后再执行插入，从根本上消除软删除标记带来的拦截。对应可直接复用的逻辑：

  // 构造匹配规则：目标存储路径 + 匹配固定文件名
  String matchSelection = MediaStore.Images.Media.RELATIVE_PATH + " LIKE ? AND "
          + MediaStore.Images.Media.DISPLAY_NAME + " = ?";
  String[] matchArgs = new String[]{
          "%Pictures/Genshin Impact Mis Builds%",
          nombrePersonaje + ".jpg"
  };
  Cursor cursor = getContentResolver().query(
          MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
          new String[]{MediaStore.Images.Media._ID},
          matchSelection,
          matchArgs,
          null
  );
  // 遍历删除所有匹配的残留条目
  if (cursor != null) {
      while (cursor.moveToNext()) {
          long itemId = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
          Uri oldItemUri = ContentUris.withAppendedId(
                  MediaStore.Images.Media.EXTERNAL_CONTENT_URI, itemId
          );
          getContentResolver().delete(oldItemUri, null, null);
      }
      cursor.close();
  }
  

• 给保存的文件名加唯一标识，从根源避免重名冲突
  修改contentValues()方法中传入的文件名规则，不要使用完全固定的文件名，附加毫秒时间戳等唯一标识，哪怕残留条目没有被及时清理，也不会因为文件名完全匹配触发系统拦截：

  // 修改DISPLAY_NAME的生成规则，追加毫秒时间戳保证唯一
  values.put(MediaStore.Images.Media.DISPLAY_NAME,
          nombrePersonaje + "_" + System.currentTimeMillis() + ".jpg");
  

• 做好insert返回值的异常兜底
  不要默认假设getContentResolver().insert()一定会返回有效Uri，当返回null时，不要静默失败，可以降级写入应用私有外部存储目录，再发送媒体扫描广播将图片加入系统相册，保证存图流程不会中断，同时给用户明确的操作反馈。

• Android 10及以上版本的MediaStore对同路径、同文件名的插入有强校验，哪怕没有软删除标记，如果之前的存图流程异常中断（比如上次存图时进程崩溃，IS_PENDING标记没有被置为false），下次插入同名文件依然会返回null，不要直接沿用Android 9及以下的存图逻辑适配高版本系统。

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