发布MAUI应用后找不到appsetting.json，如何修改连接字符串？

问题根源 #

默认情况下，MAUI项目中的appsettings.json会被设置为嵌入资源，发布后会打包到应用程序集内，没有独立的物理文件，因此无法直接修改。

解决方案步骤 #

1. 修改文件属性，让文件成为独立可访问的内容 #

在Visual Studio中右键点击appsettings.json → 属性：

• 将「生成操作」改为Content
• 将「复制到输出目录」改为如果较新则复制或始终复制

2. 调整代码的配置读取逻辑 #

MAUI不同平台的应用数据目录路径不同，需通过FileSystem.AppDataDirectory获取正确的存储路径，确保能找到并读取修改后的文件：

using System.IO;
using System.Text;
using Microsoft.Extensions.Configuration;
using Microsoft.Maui.Storage;

// 获取appsettings.json的实际存储路径
var settingsPath = Path.Combine(FileSystem.AppDataDirectory, "appsettings.json");

// 首次启动时，将初始配置文件复制到可访问目录（可选，但推荐）
if (!File.Exists(settingsPath))
{
    // 从嵌入资源读取初始内容（需保留原文件的「生成操作」为Embedded resource作为 fallback）
    using var resourceStream = typeof(App).Assembly.GetManifestResourceStream("YourAppNamespace.appsettings.json");
    using var fileStream = File.Create(settingsPath);
    resourceStream.CopyTo(fileStream);
}

// 读取并加载配置
var jsonContent = File.ReadAllText(settingsPath);
var configuration = new ConfigurationBuilder()
    .AddJsonStream(new MemoryStream(Encoding.UTF8.GetBytes(jsonContent)))
    .Build();

// 获取连接字符串
var connectionString = configuration.GetConnectionString("YourConnStrKey");

注意：替换YourAppNamespace为你的项目实际命名空间，YourConnStrKey为你在appsettings.json中定义的连接字符串键名。

3. 发布后找到并修改appsettings.json的路径 #

不同平台的文件位置如下：

• Windows：C:\Users\<你的用户名>\AppData\Local\Packages\<应用包名>\LocalState
• Android：Android/data/<应用包名>/files（需文件管理器开启显示隐藏文件权限，或通过adb pull命令导出）
• iOS：通过Xcode的「设备和模拟器」工具，找到对应应用的容器后导出文件修改；测试设备需开发者权限或越狱后用第三方文件工具访问
• macOS：~/Library/Containers/<应用包名>/Data/Library/Application Support

4. 额外注意事项 #

• 若应用已发布，首次启动时会自动复制初始配置文件到可修改目录，后续修改该目录下的文件即可生效
• 避免直接在项目输出目录修改文件，因为发布更新时可能会覆盖该目录，需修改上述平台对应的AppData目录下的文件

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