flutter module_error ai_generated true

ArgumentError：无效参数：无法加载动态库 'libnative.so'：dlopen 失败：未找到库 "libnative.so"

ArgumentError: Invalid argument(s): Failed to load dynamic library 'libnative.so': dlopen failed: library "libnative.so" not found

ID: flutter/dart-ffi-library-not-found

其他格式: JSON · Markdown 中文 · English
80%修复率
86%置信度
1证据数
2023-05-12首次发现

版本兼容性

版本状态引入弃用备注
Flutter 3.7 active — — —
Dart 3.0 active — — —
Android 12 active — — —
iOS 15 active — — —
Linux active — — —

根因分析

Dart FFI 绑定引用的原生共享库未随应用打包，或未放置在目标平台的正确目录中（Android jniLibs、iOS Frameworks 或 Linux/MacOS 库路径）。

English

A Dart FFI binding references a native shared library that is not bundled with the app or not placed in the correct directory for the target platform (Android jniLibs, iOS Frameworks, or Linux/MacOS library paths).

generic

官方文档

https://dart.dev/guides/libraries/c-interop

解决方案

  1. Place the shared library in the correct platform-specific directory: android/app/src/main/jniLibs/<abi>/ for Android, or use a Flutter plugin with native code.
  2. Use the ffi package's DynamicLibrary.process() to load symbols from the main process if the library is linked at compile time.

无效尝试

常见但无效的做法:

  1. 80% 失败

    Assets are not loaded as shared libraries; FFI requires the library to be in the system library path or bundled as a native dependency.

  2. 70% 失败

    FFI resolves library paths from the system loader, not the Dart script's location; relative paths are platform-dependent and often fail.

  3. 60% 失败

    On mobile platforms (Android/iOS), environment variables are not accessible to the app process; this only works on desktop.