Flutter Windows应用仅后台运行问题及可分发.exe构建指导

可能原因及排查步骤 #

1. 数据库初始化阻塞UI线程 #

你的main.dart中直接调用了dbHelper.db，如果这是异步初始化操作但未等待完成，可能导致UI线程阻塞或初始化异常。修改main函数为异步并等待数据库初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  sqfliteFfiInit();
  databaseFactory = databaseFactoryFfi;
  final dbHelper = DatabaseHelper.instance;
  
  // 等待数据库初始化完成，避免阻塞UI
  await dbHelper.db;

  runApp(
    MaterialApp(
      restorationScopeId: "some-Id-here",
      title: 'Attendance',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.green),
        useMaterial3: true,
      ),
      debugShowCheckedModeBanner: false,
      initialRoute: 'SplashScreen',
      routes: {
        'SplashScreen': (context) => const SplashScreen(),
      },
    ),
  );
}

2. 排查SplashScreen组件异常 #

替换初始页面为最简测试组件，验证是否是SplashScreen的问题：

// 修改routes中的SplashScreen路由
'SplashScreen': (context) => const Scaffold(
      body: Center(
        child: Text('测试页面', style: TextStyle(fontSize: 24)),
      ),
    ),

重新构建release版本运行，如果能显示测试页面，说明SplashScreen存在代码问题（比如布局全透明、异步操作未处理、组件渲染失败等），需要针对性排查SplashScreen.dart的代码。

3. 检查Windows窗口配置 #

打开项目的windows/runner/main.cpp，确认窗口初始化代码正常：

// 确保窗口大小设置正常，没有隐藏窗口的参数
Win32Window::Size size(800, 600);
if (!window.CreateAndShow(L"Attendance", origin, size)) {
  return EXIT_FAILURE;
}

如果窗口尺寸被设为(0,0)或调用CreateAndShow时传入隐藏参数，会导致界面无法显示。

4. 查看控制台错误日志 #

打开命令提示符，进入release文件夹（build/windows/x64/release/runner/），直接运行exe文件：

attendance_system.exe

查看控制台输出的错误信息，比如数据库初始化失败、依赖DLL缺失等，这些异常可能导致程序后台运行而无法渲染界面。

1. 生成Release版本文件 #

在项目根目录执行以下命令，构建正式版Windows应用：

flutter build windows --release

构建完成后，所有可运行的文件会生成在build/windows/x64/release/runner/目录下，包括exe、依赖DLL、资源文件等，必须将该目录下的所有文件一起分发，单独的exe无法运行。

2. 使用Inno Setup制作安装包 #

1. 下载并安装Inno Setup，打开软件后新建脚本，填入以下示例内容（根据你的项目信息修改）：

[Setup]
AppName=Attendance System
AppVersion=1.0.0
DefaultDirName={autopf}\Attendance System
DefaultGroupName=Attendance System
OutputDir=.\installer
OutputBaseFilename=Attendance_Setup
Compression=lzma2
SolidCompression=yes

[Files]
; 将runner目录下的所有文件打包到安装目录
Source: "build\windows\x64\release\runner\*"; DestDir: "{app}"; Flags: recursesubdirs createallsubdirs

[Icons]
; 开始菜单快捷方式
Name: "{group}\Attendance System"; Filename: "{app}\attendance_system.exe"
; 桌面快捷方式（可选）
Name: "{commondesktop}\Attendance System"; Filename: "{app}\attendance_system.exe"; Tasks: desktopicon

[Tasks]
Name: desktopicon; Description: "创建桌面快捷方式"; GroupDescription: "附加图标:"; Flags: unchecked

2. 替换attendance_system.exe为你的实际项目exe文件名，点击编译即可生成可分发的安装包。

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