Flutter使用open_file包出现LateInitializationError问题求助

问题 #

在Debian 12环境下运行Flutter应用，使用open_file包打开docx/xlsx文件时出现初始化错误。

代码示例 #

import 'package:flutter/material.dart';
import 'package:open_file/open_file.dart';

class WordViewerPage extends StatelessWidget {
  final String filePath;

  WordViewerPage({required this.filePath});

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<OpenResult>(
      future: OpenFile.open(filePath),
      builder: (BuildContext context, AsyncSnapshot<OpenResult> snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        } else if (snapshot.hasError) {
          print('Error occurred: ${snapshot.error}'); // Log the error
          return Center(child: Text("Error: ${snapshot.error}"));
        } else if (snapshot.hasData) {
          // Check if the file opened successfully
          if (snapshot.data?.type == ResultType.done) {
            return const SingleChildScrollView(
              padding: EdgeInsets.all(16.0),
              child: Text("File opened successfully!"),
            );
          } else {
            return Center(
                child: Text("Could not open file: ${snapshot.data?.message}"));
          }
        }
        return const Center(child: Text("Unexpected state."));
      },
    );
  }
}

报错信息 #

flutter: Error occurred: LateInitializationError: Field '_instance@1198239922' has not been initialized.

解决方案 #

该错误源于open_file包对Linux平台（Debian 12）的支持不完善，可通过以下几种方式解决：

• 替换为open_filex包：这是open_file的修复分支，解决了Linux下的初始化问题

  1. 更新pubspec.yaml依赖：

     dependencies:
       open_filex: ^4.3.2 # 建议使用最新版本
     

  2. 修改代码中的导入语句：

     import 'package:open_filex/open_filex.dart';
     

  3. 原有OpenFile.open(filePath)的调用逻辑无需修改，直接复用即可

• 使用url_launcher调用系统默认程序：

  1. 添加url_launcher依赖：

     dependencies:
       url_launcher: ^6.1.12 # 使用最新版本
     

  2. 替换原文件打开逻辑：

     import 'package:url_launcher/url_launcher.dart';
     
     Future<void> openFile(String filePath) async {
       final Uri fileUri = Uri.file(filePath);
       if (await canLaunchUrl(fileUri)) {
         await launchUrl(fileUri);
       } else {
         throw Exception('无法打开文件：$filePath');
       }
     }
     

• 直接执行系统命令xdg-open：Debian系统原生支持该命令打开文件，通过Process.run执行：

  import 'dart:io';
  
  Future<void> openFile(String filePath) async {
    await Process.run('xdg-open', [filePath]);
  }
  

内容的提问来源于stack exchange，提问作者Samier Uddin Ahammad Shovo