MAUI iOS Debug模式可保存Preferences，Release/TestFlight模式失效

问题描述 #

• 在Mac/Windows的VS2022中，Debug配置构建应用时，Preferences保存读取功能正常
• Android版本Release构建发布后，Preferences功能正常
• iOS版本以Release配置构建并通过TestFlight测试时，Preferences无法保存和读取
• 额外测试结果：Debug模式下，使用开发者证书+开发者描述文件时功能正常；使用分发证书+分发描述文件时功能失效

当前使用的读写代码 #

public void CreateItem(string key, dynamic value) {
    Preferences.Default.Set(key, value);
}

public string GetString(string key) {
    String contents = null;

    try {
        contents = Preferences.Get(key, null);
    }
    catch (Exception ex) {
    }
    return contents;
}

可能的解决方法 #

1. 检查iOS沙盒与权限配置 #

iOS分发构建的沙盒限制更严格，确保Info.plist中未禁用必要的沙盒配置，默认开启沙盒即可，不要手动修改UserDefaults相关的权限项。

2. 明确指定Preferences存储容器 #

iOS分发构建可能因容器ID问题导致存储路径异常，尝试指定应用Bundle ID作为存储容器：

// 写入时指定容器
var prefs = Preferences.GetSharedPreferences(AppInfo.Current.BundleIdentifier);
prefs.Set(key, value);

// 读取时同步使用指定容器
var contents = prefs.Get(key, null);

3. 调整Release构建的链接器选项 #

VS的iOS项目Release配置下，若链接器行为设置为「链接所有程序集」，可能导致Preferences相关的.NET绑定代码被误优化剥离。建议将链接器行为改为「仅链接SDK程序集」，保留应用自身的代码逻辑。

4. 重新验证分发描述文件 #

确保分发描述文件与App Store Connect中的应用Bundle ID完全匹配，且未过期、权限配置完整。重新生成并导入描述文件，避免因配置不一致导致存储权限异常。

5. 增加错误日志排查 #

修改读取方法，不要吞掉异常，输出详细错误信息以便定位问题：

public string GetString(string key) {
    String contents = null;

    try {
        contents = Preferences.Get(key, null);
    }
    catch (Exception ex) {
        Foundation.NSLog($"Preferences读取错误: {ex.Message}\n{ex.StackTrace}");
        Console.WriteLine($"Preferences读取错误: {ex.Message}\n{ex.StackTrace}");
    }
    return contents;
}

通过TestFlight测试时，收集设备日志查看具体异常信息。

6. 确认iOS版本兼容性 #

确保测试设备的iOS版本与应用部署目标版本兼容，排除旧版本系统对UserDefaults的特殊限制。

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