<think>
我们正在解决在MauiProgram中加入UseSkiaSharp后运行报
System.BadImageFormatException（Invalid field token 0x040000a1）错误的问题。根据错误信息，这通常与
程序集加载问题有关，尤其是在混合使用32位和64位
程序集时。以下将针对该问题提供解决方案。
参考之前的引用内容，
System.BadImageFormatException通常是由于平台目标
不匹配引起的。例如，在64位进程中
加载了32位的DLL，
或者在32位进程中
加载了64位的DLL。在
.NET MAUI项目中，当我们引入SkiaSharp时，需要确保所有相关的库都匹配目标平台。
### 解决步骤
#### 1
. **检查项目平台目标**
在Visual Studio中：
- 右键单击项目 -> 属性
- 进入“生成”选项卡（
或“Build”）
- 检查“平台目标”（Platform target）设置
对于
.NET MAUI应用，我们通常需要为每个平台单独设置。但由于MAUI是多目标项目，我们需要检查每个目标平台（Android, iOS, Windows等）的配置。
**特别注意**：对于Windows平台（如Windows应用包项目），我们需要确保平台目标一致。如果使用Any CPU，则在64位系统上会以64位运行，若引用了32位的库则会导致异常。
建议将平台目标设置为x86（32位）
或x64（64位）以匹配所引用的SkiaSharp库的位数。通常，SkiaSharp的NuGet包会提供对应平台的本地库，因此我们需要确保整个应用的目标平台与这些本地库一致。
在项目
文件(
.csproj)中，我们可以通过以下方式设置：
```xml
<PropertyGroup>
<!-- 针对Windows平台设置 -->
<PlatformTarget>x86</PlatformTarget>
<!--
或者 -->
<PlatformTarget>x64</PlatformTarget>
</PropertyGroup>
```
但是，请注意，在
.NET MAUI中，我们可能需要为
不同的运行时标识符（RID）设置
不同的平台目标。可以通过条件属性设置：
```xml
<PropertyGroup Condition="'$(RuntimeIdentifier)' == 'win-x86'">
<PlatformTarget>x86</PlatformTarget>
</PropertyGroup>
<PropertyGroup Condition="'$(RuntimeIdentifier)' == 'win-x64'">
<PlatformTarget>x64</PlatformTarget>
</PropertyGroup>
```
#### 2
. **清理和重新安装SkiaSharp**
有时，NuGet包可能未
正确安装
或已损坏。尝试执行以下步骤：
- 在解决方案资源管理器中，右键单击解决方案 -> “清理解决方案”
- 删除项目的`bin`和`obj`
文件夹
- 打开NuGet包管理器控制台，执行以下命令：
```
Update-Package -reinstall
```
-
或者，卸载SkiaSharp相关包，然后重新安装
确保安装的SkiaSharp版本兼容当前的
.NET MAUI版本。检查SkiaSharp
.Views
.Maui
.Controls和SkiaSharp
.Views
.Maui
.Core的版本。
#### 3
. **检查框架安装**
引用[3]中提到，有时框架安装路径错误也可能导致类似问题。确保开发机器上安装了
正确的
.NET框架版本。对于
.NET MAUI，我们使用的是
.NET 6/7/8，而
不是
.NET Framework。但是，如果涉及到Windows平台，需要确保安装了对应的Windows SDK。
运行以下命令检查运行时：
```
dotnet --list-runtimes
```
确保有类似以下的输出：
```
Microsoft
.WindowsDesktop
.App 6
.0
.0 [C
:\Program Files\dotnet\shared\Microsoft
.WindowsDesktop
.App]
```
#### 4
. **验证
程序集加载**
使用`dotnet publish`命令发布应用
程序，并检查输出目录中的
程序集。可以使用工具如`corflags`检查
程序集的位数。
例如，对于Windows平台，打开开发者命令提示符（Developer Command Prompt），导航到输出目录，运行：
```
corflags YourSkiaSharpAssembly
.dll
```
查看输出的`32BIT`标志。如果为1，则是32位
程序集；为0则是64位。确保所有
程序集的目标位数一致。
#### 5
. **使用
正确的SkiaSharp初始化**
在`MauiProgram
.cs`中，我们使用`UseSkiaSharp`方法。确保在创建`MauiApp`之前调用：
```csharp
using SkiaSharp
.Views
.Maui
.Controls
.Hosting;
var builder = MauiApp
.CreateBuilder();
builder
.UseMauiApp<App>()
.UseSkiaSharp(); // 确保调用此方法
```
另外，注意`UseSkiaSharp`的调用顺序，最好在`UseMauiApp`之后立即调用。
#### 6
. **检查
依赖项**
确保项目中所有引用的库（包括间接引用）都是针对相同平台构建的。例如，如果项目引用了其他第三方库，这些库可能依赖于特定的平台架构。
### 错误排查流程图
```mermaid
graph TD
A[出现
System.BadImageFormatException] --> B{平台目标设置是否
正确}
B -->|否| C[设置项目平台目标为x86
或x64]
B -->|是| D{SkiaSharp是否
正确安装}
D -->|否| E[重新安装SkiaSharp]
D -->|是| F{
依赖项是否一致}
F -->|否| G[确保所有
依赖项为相同架构]
F -->|是| H[清理和重建项目]
```
### 相关问题
1
. 如何检查
.NET MAUI项目中
程序集的位数？[^1]
2
. SkiaSharp在
.NET MAUI中的最佳实践有哪些？[^2]
3
. 如何处理
.NET MAUI中的混合模式
程序集加载问题？[^3]
[^1]
: 使用`corflags`工具
或检查
程序集属性
[^2]
: 确保在MauiProgram中
正确初始化并关注资源管理
[^3]
: 统一平台目标并使用条件编译
</think>
### 解决 MauiProgram 加入 UseSkiaSharp 后报 `
System.BadImageFormatException` 错误
#### 错误原因分析
`
System.BadImageFormatException (Invalid field token 0x040000a1)` 通常表示 **
程序集加载冲突**，根本原因是：
1
. **平台架构
不匹配**：SkiaSharp 的本地库（32位/64位）与当前运行环境
不兼容[^1]
2
. **混合编译模式**：`
.NET MAUI` 项目默认使用 `AnyCPU`，但 SkiaSharp 的本地库有架构限制
3
. **
程序集损坏**：NuGet 包未
正确安装
或缓存损坏
#### 解决方案
##### 1
. 统一目标平台架构（首选方案）
在 **项目
文件 (
.csproj)** 中显式指定架构：
```xml
<PropertyGroup>
<!-- 选择以下任一架构 -->
<PlatformTarget>x64</PlatformTarget> <!-- 64位系统 -->
<PlatformTarget>x86</PlatformTarget> <!-- 32位系统 -->
</PropertyGroup>
```
**理由**：`AnyCPU` 在64位系统自动以64位运行，但 SkiaSharp 的本地库可能
不兼容[^2]
##### 2
. 强制清理 NuGet 缓存
在 **命令行** 执行：
```bash
# 清理全局 NuGet 缓存
dotnet nuget locals all --clear
# 删除项目本地缓存
rmdir /s /q bin
rmdir /s /q obj
```
##### 3
. 验证 SkiaSharp 安装
确保所有相关包版本一致：
```xml
<PackageReference Include="SkiaSharp" Version="2
.88
.6" />
<PackageReference Include="SkiaSharp
.Views
.Maui
.Controls" Version="2
.88
.6" />
<PackageReference Include="SkiaSharp
.Views
.Maui
.Core" Version="2
.88
.6" />
```
**注意**：版本号需完全相同（示例为当前最新版）
##### 4
. 修复框架配置（仅Windows）
```bash
cd C
:\Windows\Microsoft
.NET\Framework\v4
.0
.30319
aspnet_regiis
.exe -i
```
此命令修复
.NET框架安装注册[^3]
##### 5
. 完整修复流程
```mermaid
graph LR
A[错误出现] --> B[设置PlatformTarget]
B --> C[清理NuGet缓存]
C --> D[删除bin/obj目录]
D --> E[重启VS]
E --> F[重新编译]
```
#### 关键验证点
1
. 查看 **输出窗口** 的
加载日志：
```
Loaded 'C
:\Users\
xxx\
.nuget\packages\skiaSharp\2
.88
.6\runtimes\win-x64\native\libSkiaSharp
.dll'
```
2
. 确认日志中
加载的架构（`win-x64`/`win-x86`）与 `PlatformTarget` 匹配
#### 相关问题
1
. 如何检测当前
程序运行在32位还是64位模式？[^1]
2
. .NET MAUI 中混合引用原生库的最佳实践是什么？[^2]
3
. SkiaSharp 性能优化有哪些关键技巧？[^3]
4
. 如何诊断
.NET
程序集加载失败的根本原因？
[^1]
: 通过 `Environment
.Is64BitProcess` 属性检测
[^2]
: 使用 `RuntimeIdentifiers` 精确控制目标平台
[^3]
: 启用 GPU 加速和调整渲染管线
本文讨论了工程生成目标平台不一致导致的问题，并提供了解决方案。建议检查项目设置，确保所有模块指向相同的目标平台。
扫一扫
2730
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
