Flutter从服务器下载PDF文件失败问题求助

问题核心分析 #

从错误日志和代码片段来看，下载失败由两个关联问题导致：

1. 存储配置不匹配：日志提示It looks like you are trying to save file in public storage but not setting 'saveInPublicStorage' to 'true'，说明你指定的存储目录属于公共存储区域，但未开启Flutter Downloader对应的配置参数。
2. 空指针异常：createFileInAppSpecificDir函数在创建文件失败时返回null，后续downloadFile方法（第393行）使用这个null对象触发了java.lang.NullPointerException。

查看代码逻辑：当newFile.createNewFile()返回false时（通常因公共存储无写入权限且未配置参数导致），函数直接返回null，没有处理后续的空指针风险。

解决方案 #

1. 开启公共存储配置参数 #

如果确实需要将文件保存到公共存储目录，在调用下载方法时必须添加saveInPublicStorage: true参数：

FlutterDownloader.enqueue(
  url: "你的PDF文件服务器地址",
  savedDir: "/storage/emulated/0/Download", // 示例公共存储目录
  saveInPublicStorage: true, // 关键配置，必须开启
  showNotification: true,
  openFileFromNotification: true,
);

2. 确保存储权限配置 #

• 在AndroidManifest.xml中声明必要权限：

<!-- Android 9及以下需要 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 10+ 需要管理外部存储权限（可选，若使用公共存储） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

• Android 6.0+ 需在运行时动态请求存储权限，可使用permission_handler库实现。

3. 切换到应用私有存储（推荐） #

若无需将文件暴露到公共目录，改用应用私有存储可避免权限和配置问题：

import 'package:path_provider/path_provider.dart';

// 获取应用私有文档目录
final Directory appDocsDir = await getApplicationDocumentsDirectory();
final String savedDir = appDocsDir.path;

FlutterDownloader.enqueue(
  url: "你的PDF文件服务器地址",
  savedDir: savedDir,
  showNotification: true,
  openFileFromNotification: true,
);

这种方式无需设置saveInPublicStorage，Android 10+ 也无需额外存储权限。

4. 修复空指针根源（自定义代码场景） #

如果你需要修改原生DownloadWorker.kt代码，可优化createFileInAppSpecificDir函数，避免返回null：

private fun createFileInAppSpecificDir(filename: String, savedDir: String): File? {
    val newFile = File(savedDir, filename)
    try {
        // 先确保父目录存在
        newFile.parentFile?.let { parentDir ->
            if (!parentDir.exists()) {
                parentDir.mkdirs()
            }
        }
        val rs: Boolean = newFile.createNewFile()
        if (rs) {
            return newFile
        } else {
            logError("文件创建失败：存储目录不可写或权限不足")
            // 返回临时文件避免空指针，或根据业务逻辑抛出异常
            return File.createTempFile("pdf_temp_", ".pdf")
        }
    } catch (e: IOException) {
        e.printStackTrace()
        logError("创建文件失败：${e.message}")
        return null
    }
}

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