.NET 6类库读取内嵌资源文件路径问题求助

一、修复类库中config.json的读取路径问题 #

方法1：将文件设置为嵌入式资源（推荐） #

这是最可靠的方式，文件会被嵌入到类库的程序集中，不依赖外部文件路径：

1. 在类库项目中，右键Resources\config.json → 属性
2. 将生成操作改为「嵌入式资源」，复制到输出目录改为「不复制」
3. 使用程序集读取嵌入式资源：

using System.Reflection;
using System.IO;

// 替换为你类库中任意类的类型，用来获取类库程序集
var assembly = typeof(YourToolkitClass).Assembly;
// 资源名称格式：[类库命名空间].[文件夹名].[文件名]，比如类库命名空间是MyAwsToolkit，就是MyAwsToolkit.Resources.config.json
var resourceFullName = $"{assembly.GetName().Name}.Resources.config.json";

using (Stream resourceStream = assembly.GetManifestResourceStream(resourceFullName))
using (StreamReader reader = new StreamReader(resourceStream))
{
    string json = reader.ReadToEnd();
    // 后续反序列化逻辑
}

可以通过assembly.GetManifestResourceNames()方法打印所有嵌入式资源名称，确认目标文件的名称是否正确。

方法2：将文件复制到输出目录并读取类库程序集路径 #

如果需要保留独立的配置文件（方便后续修改），可以用这种方式：

1. 在类库项目中，右键Resources\config.json → 属性
2. 将复制到输出目录改为「始终复制」，生成操作改为「内容」
3. 在类库的.csproj文件中添加NuGet包的文件包含配置，确保文件被打包到NuGet中：

<ItemGroup>
  <Content Include="Resources\config.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <PackageCopyToOutput>true</PackageCopyToOutput>
  </Content>
</ItemGroup>

4. 读取时获取类库程序集的目录，而非当前应用的目录：

using System.Reflection;
using System.IO;

// 获取类库程序集所在的目录
var assemblyDirectory = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
var configPath = Path.Combine(assemblyDirectory, "Resources\\config.json");

using (StreamReader reader = new StreamReader(configPath))
{
    string json = reader.ReadToEnd();
    // 后续反序列化逻辑
}

二、更优的API URI存储方案 #

方案1：使用.NET配置系统+依赖注入（推荐） #

让类库依赖.NET的配置体系，由宿主Web应用提供配置，支持多环境切换：

1. 在类库中定义强类型配置类：

public class AwsApiUris
{
    public string UserManagementApi { get; set; }
    public string OrderProcessingApi { get; set; }
    // 其他API URI
}

2. Web应用的appsettings.json中添加配置：

"AwsApiUris": {
  "UserManagementApi": "https://your-api-gateway-url/users",
  "OrderProcessingApi": "https://your-api-gateway-url/orders"
}

3. Web应用的Program.cs中注册配置：

builder.Services.Configure<AwsApiUris>(builder.Configuration.GetSection("AwsApiUris"));

4. 类库中的服务通过依赖注入获取配置：

public class AwsApiClient
{
    private readonly AwsApiUris _apiUris;

    // 通过构造函数注入IOptions
    public AwsApiClient(IOptions<AwsApiUris> apiUrisOptions)
    {
        _apiUris = apiUrisOptions.Value;
    }

    public async Task CallUserApi()
    {
        // 使用_apiUris.UserManagementApi作为请求地址
    }
}

方案2：定义常量类（适用于URI固定不变的场景） #

如果API URI不会随环境变化，可以直接在类库中定义常量：

public static class AwsApiConstants
{
    public const string UserManagementApi = "https://your-api-gateway-url/users";
    public const string OrderProcessingApi = "https://your-api-gateway-url/orders";
}

这种方式最简单，但无法动态修改，适合URI长期固定的场景。

方案3：使用嵌入式资源+强类型反序列化 #

结合第一种路径解决方法，将嵌入式的config.json反序列化为强类型配置类，避免直接操作JSON字符串：

using System.Reflection;
using System.IO;
using System.Text.Json;

public static AwsApiUris LoadApiUris()
{
    var assembly = typeof(YourToolkitClass).Assembly;
    var resourceName = $"{assembly.GetName().Name}.Resources.config.json";
    
    using (Stream stream = assembly.GetManifestResourceStream(resourceName))
    using (StreamReader reader = new StreamReader(stream))
    {
        string json = reader.ReadToEnd();
        return JsonSerializer.Deserialize<AwsApiUris>(json);
    }
}

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