移动1G大文件触发NullPointerException问题求助

问题现象 #

移动1GB大小的文件时抛出空指针异常，错误信息：

java.lang.NullPointerException: 尝试在空对象引用上调用虚拟方法 'android.os.Parcelable android.os.Bundle.getParcelable(java.lang.String)'

错误日志 #

09-16 14:19:05.231  1840  1866 W ActivityManager: Spurious death for ProcessRecord{bebf0e 0:com.android.externalstorage/u0a53}, curProc for 5739: null
09-16 14:19:05.236  5542  6158 W DocumentsContract: Failed to move document
09-16 14:19:05.236  5542  6158 W DocumentsContract: java.lang.NullPointerException: Attempt to invoke virtual method 'android.os.Parcelable android.os.Bundle.getParcelable(java.lang.String)' on a null object reference
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at android.provider.DocumentsContract.moveDocument(DocumentsContract.java:1472)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at com.android.documentsui.services.MoveJob.processDocument(MoveJob.java:152)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at com.android.documentsui.services.CopyJob.processDocumentThenUpdateProgress(CopyJob.java:355)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at com.android.documentsui.services.CopyJob.start(CopyJob.java:230)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at com.android.documentsui.services.Job.run(Job.java:160)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:462)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at java.util.concurrent.FutureTask.run(FutureTask.java:266)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641)
09-16 14:19:05.236  5542  6158 W DocumentsContract:     at java.lang.Thread.run(Thread.java:919)

代码定位 #

从DocumentsContract.moveDocument的实现来看，空指针出现在out.getParcelable(DocumentsContract.EXTRA_URI)一行：

/**
 * 将指定文档移动到新的父目录下。
 *
 * @param sourceDocumentUri 带有 {@link Document#FLAG_SUPPORTS_MOVE} 的文档
 * @param sourceParentDocumentUri 待移动文档的父文档
 * @param targetParentDocumentUri 将成为源文档新父目录的文档
 * @return 移动后的文档，若失败则返回 {@code null}
 */
public static @Nullable Uri moveDocument(@NonNull ContentResolver content,
        @NonNull Uri sourceDocumentUri, @NonNull Uri sourceParentDocumentUri,
        @NonNull Uri targetParentDocumentUri) throws FileNotFoundException {
    try {
        final Bundle in = new Bundle();
        in.putParcelable(DocumentsContract.EXTRA_URI, sourceDocumentUri);
        in.putParcelable(DocumentsContract.EXTRA_PARENT_URI, sourceParentDocumentUri);
        in.putParcelable(DocumentsContract.EXTRA_TARGET_URI, targetParentDocumentUri);

        final Bundle out = content.call(sourceDocumentUri.getAuthority(),
                METHOD_MOVE_DOCUMENT, null, in);
        return out.getParcelable(DocumentsContract.EXTRA_URI); // 这里触发NPE，因为out为null
    } catch (Exception e) {
        Log.w(TAG, "Failed to move document", e);
        rethrowIfNecessary(e);
        return null;
    }
}

根因分析 #

日志里的Spurious death for ProcessRecord{bebf0e 0:com.android.externalstorage/u0a53}是关键线索：负责处理外部存储操作的系统进程com.android.externalstorage意外崩溃，导致ContentResolver.call()无法获取有效返回Bundle，直接返回null。大文件移动时系统资源占用高，容易触发这类进程崩溃问题。

解决思路 #

1. 捕获异常避免崩溃
   在调用moveDocument时主动捕获空指针，同时检查返回值是否为null，做降级处理：

   try {
       Uri movedUri = DocumentsContract.moveDocument(
               getContentResolver(),
               sourceDocUri,
               sourceParentUri,
               targetParentUri
       );
       if (movedUri == null) {
           // 处理移动失败场景，比如提示用户或执行备份逻辑
       }
   } catch (NullPointerException e) {
       // 捕获进程崩溃导致的空指针
       Log.e(TAG, "移动文件失败：外部存储进程异常", e);
       // 触发重试或改用其他方案
   } catch (FileNotFoundException e) {
       Log.e(TAG, "移动文件失败：源文件或目标目录不存在", e);
   }
   

2. 增加重试机制
   针对大文件移动，添加重试逻辑（比如最多重试2-3次），因为进程崩溃可能是偶发的资源不足问题：

   private boolean moveLargeFileWithRetry(Uri sourceDocUri, Uri sourceParentUri, Uri targetParentUri, int retryCount) {
       for (int i = 0; i < retryCount; i++) {
           try {
               Uri movedUri = DocumentsContract.moveDocument(getContentResolver(), sourceDocUri, sourceParentUri, targetParentUri);
               if (movedUri != null) {
                   return true;
               }
           } catch (Exception e) {
               Log.w(TAG, "第" + (i+1) + "次移动失败", e);
               try {
                   Thread.sleep(1000); // 重试前短暂等待
               } catch (InterruptedException ignored) {}
           }
       }
       return false;
   }
   

3. 替代方案优化

   • 同存储介质内移动：直接使用文件系统重命名（File.renameTo()或Files.move()），比通过DocumentsContract更高效稳定，避免跨进程调用的风险。
   • 跨存储介质移动：先复制文件到目标目录，成功后再删除原文件，全程自己控制进度和异常处理。

4. 权限与系统适配

   • 确保应用拥有足够的存储权限：比如MANAGE_EXTERNAL_STORAGE（针对Android 10+）或通过SAF获取的目标目录读写权限。
   • 旧版本系统兼容：部分Android 8/9版本可能存在DocumentsContract的bug，可针对这些版本直接使用文件操作替代。

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