Windows正常的HanumanInstitute.LibMpv.Avalonia项目在Ubuntu运行报错‘无法加载libmpv.2’

1. 安装系统层面的libmpv2库 #

Ubuntu默认包可能未提供程序所需的libmpv.so.2，直接通过包管理器安装对应版本：

sudo apt update
sudo apt install libmpv2

这个包会自动在/usr/lib/x86_64-linux-gnu/下生成libmpv.so.2文件及正确的符号链接，覆盖你之前手动复制的无效文件。

2. 验证库文件状态 #

安装完成后，执行命令确认文件存在：

ls -l /usr/lib/x86_64-linux-gnu/libmpv.so.2

如果输出显示文件路径和链接关系，说明系统库已就绪。

3. 修复.NET程序的库搜索路径（若仍报错） #

如果系统安装后还是找不到，可能是.NET未正确识别系统库路径，两种解决方式：

• 方式一：添加运行时配置
  在项目根目录创建runtimeconfig.template.json，内容如下：

  {
    "runtimeOptions": {
      "additionalProbingPaths": ["/usr/lib/x86_64-linux-gnu/"]
    }
  }
  

  重新发布或运行项目，.NET会优先从指定路径加载库。
• 方式二：临时设置环境变量
  运行程序前执行：

  export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
  dotnet YourApp.dll
  

  临时扩展系统的库搜索路径。

4. 纠正手动复制库的错误操作 #

你之前复制libmpv.so到项目目录无效的原因是：libmpv.so只是指向当前最新版本的软链接，而程序明确依赖的是libmpv.so.2这个特定版本的库文件。直接复制软链接或原文件到项目目录会破坏动态链接的依赖链，正确做法是通过包管理器安装官方维护的库。

5. 自包含部署的额外处理 #

如果你的项目是自包含发布的，需要确保目标Ubuntu机器预先安装libmpv2，或者在发布时通过NativeLibrary相关配置打包必要的库文件（优先推荐使用系统包）。

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