Flutter PDF下载器报错：Null check operator空值使用问题求助

1. 检查回调注册时机 #

FlutterDownloader.registerCallback必须在主线程且Flutter引擎初始化完成后调用，不能直接放在main()最开头，也不能在异步延迟逻辑里调用。正确写法示例：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 先初始化下载器
  await FlutterDownloader.initialize(
      debug: true,
      ignoreSsl: true // 若需下载HTTPS链接可开启
  );
  // 注册全局回调
  FlutterDownloader.registerCallback(downloadCallback);
  runApp(const MyApp());
}

// 回调必须是全局顶层函数或静态函数
void downloadCallback(String id, DownloadTaskStatus status, int progress) {
  // 处理下载状态更新逻辑
}

2. 确认平台配置完整性 #

Android端 #

在android/app/src/main/AndroidManifest.xml补全权限与服务声明：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

<application ...>
  <service
      android:name="vn.hunghd.flutterdownloader.DownloadService"
      android:exported="false">
      <intent-filter>
          <action android:name="android.intent.action.DOWNLOAD_COMPLETE"/>
      </intent-filter>
  </service>
</application>

同时确保android/build.gradle中minSdkVersion不低于16。

iOS端 #

在ios/Runner/Info.plist添加权限描述：

<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要访问相册保存下载的PDF文件</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册保存下载的PDF文件</string>

若需后台下载，在Xcode中给项目开启Background Modes，勾选Background fetch和Remote notifications。

3. 修正回调函数写法 #

回调函数必须满足：

• 是全局顶层函数或类静态函数，不能是普通成员函数
• 参数类型严格匹配String id, DownloadTaskStatus status, int progress
• 不要在回调里直接更新UI，需通过WidgetsBinding或状态管理工具通知UI：

void downloadCallback(String id, DownloadTaskStatus status, int progress) {
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // 在这里更新状态或通知UI组件刷新
  });
}

4. 排查版本兼容性 #

确保flutter_downloader版本与当前Flutter SDK兼容，执行flutter pub upgrade flutter_downloader更新依赖，之后运行flutter clean和flutter run重新构建项目。

5. 定位空指针具体来源 #

如果以上步骤无效，添加日志排查初始化与注册过程：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  try {
    var initResult = await FlutterDownloader.initialize(debug: true);
    print("下载器初始化结果: $initResult");
    FlutterDownloader.registerCallback(downloadCallback);
    print("回调注册成功");
  } catch (e, stack) {
    print("注册失败错误信息: $e");
    print(stack);
  }
  runApp(const MyApp());
}

若初始化失败，重点检查平台配置是否遗漏；若注册时出错，确认回调函数是否符合要求。

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