.NET MAUI安卓版：Release认证触发GeneralSecurityException，Debug正常

我用.NET MAUI开发移动应用，Debug模式下一切运行正常，但切换到Release模式进行认证时，触发Java.Security.GeneralSecurityException错误。

环境配置与已尝试操作 #

• 目标框架：net8.0-android的.NET MAUI应用
• IDE：Visual Studio 2022
• 存储方式：使用SecureStorage存储令牌
• 业务场景：与后端服务进行认证

已执行的排查操作：

• 验证AndroidManifest.xml中的权限配置
• 清理并重建项目

错误仅在认证成功时触发，需要了解该问题仅在Release构建中出现的原因及解决方法。

相关代码 #

Login命令实现 #

[RelayCommand]
private async Task Login()
{
    try
    {
        var tokenResponse = await _authenticationService.AuthenticateAsync(PinGet!, PasswordGet!);
        if (tokenResponse == null)
        {
            await Shell.Current.DisplayAlert("Error", "Authentication failed", "OK");
            return;
        }

        await SecureStorage.SetAsync("access_token", tokenResponse.JwtToken!);
        await SecureStorage.SetAsync("refresh_token", tokenResponse.RefreshToken!);

        await Shell.Current.DisplayAlert("Success", "Logged in successfully", "OK");
        await Shell.Current.GoToAsync(nameof(HomePage));
    }
    catch (Exception ex)
    {
        await Shell.Current.DisplayAlert("Error", $"An error occurred: {ex.Message}", "OK");
    }
}

AndroidManifest.xml配置 #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="Mobile.Mobile">
    <application android:allowBackup="true" android:icon="@mipmap/mainicon2" android:supportsRtl="true" android:usesCleartextTraffic="true" android:label="Mobile">
    </application>
    
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.BATTERY_STATS" />
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
    <uses-feature android:name="android.hardware.location" android:required="false" />
    <uses-feature android:name="android.hardware.location.gps" android:required="false" />
    <uses-feature android:name="android.hardware.location.network" android:required="false" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.RECORD_VIDEO" />
    <uses-permission android:name="android.permission.USE_BIOMETRIC" />
    <uses-permission android:name="android.permission.USE_FINGERPRINT" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />
</manifest>

核心原因 #

1. 代码混淆破坏加密类：Release模式默认启用代码混淆（R8/ProGuard），会对SecureStorage依赖的Android加密框架类（如androidx.security、com.google.crypto.tink）进行压缩或重命名，导致加密逻辑失效。
2. 密钥库配置问题：Release构建要求应用必须签名，若签名密钥配置错误或未配置，会导致密钥库无法正常生成加密密钥，触发安全异常。
3. Android 14加密规则限制：目标SDK 34对应Android 14，其加密权限和密钥生成逻辑更严格，Release模式下的优化可能篡改SecureStorage的加密流程。

解决方法 #

1. 保留加密相关类的混淆规则 #

在Android项目的Platforms/Android/Proguard.cfg中添加以下规则，防止加密类被混淆：

-keep class androidx.security.** { *; }
-keep class com.google.crypto.tink.** { *; }
-keep class Microsoft.Maui.Storage.** { *; }

2. 配置正确的Release签名 #

在Visual Studio中打开项目属性，进入Android -> 签名选项卡，选择有效的密钥存储文件，填写别名、密码等信息，确保Release构建使用合法签名。

3. 优化SecureStorage调用方式 #

将两次SetAsync调用合并为批量操作，减少密钥库访问次数：

await Task.WhenAll(
    SecureStorage.SetAsync("access_token", tokenResponse.JwtToken!),
    SecureStorage.SetAsync("refresh_token", tokenResponse.RefreshToken!)
);

4. 更新.NET MAUI版本 #

确保使用最新稳定版的.NET MAUI，修复已知的Android 14兼容性问题，尤其是SecureStorage相关的Bug。

5. 补充Android 14权限（可选） #

针对Android 14，可在Manifest中添加密钥管理权限（需注意该权限需特殊声明，仅必要时使用）：

<uses-permission android:name="android.permission.MANAGE_KEYS" />

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