Linux上.NET 8 dotnet-isolated Azure函数路径异常问题排查

问题描述 #

在Linux环境部署基于.NET 8的dotnet-isolated模式Azure函数应用时，使用Directory.GetCurrentDirectory()作为配置文件基础路径，仅在Azure运行时出现appsettings.json找不到的问题，生成的路径混合了Windows与Linux格式：'/tmp/functions\standby\wwwroot/appsettings.json'。

错误信息：

Unhandled exception. System.IO.FileNotFoundException: The configuration file 'appsettings.json' was not found and is not optional. The expected physical path was '/tmp/functions\standby\wwwroot/appsettings.json'.

项目.csproj关键配置：

<ItemGroup>
  <Content Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
  <Content Include="appsettings.development.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>Never</CopyToPublishDirectory>
  </Content>
</ItemGroup>

原因分析 #

1. 路径分隔符混合问题：Azure Functions Linux托管环境中，Directory.GetCurrentDirectory()返回的路径包含混合分隔符（反斜杠\+正斜杠/），这是Functions Runtime内部跨平台兼容逻辑导致的，本地运行环境路径分隔符统一，因此无此问题。
2. Isolated模式工作目录差异：Dotnet-isolated模式下，函数应用的工作目录（GetCurrentDirectory()返回值）与实际应用程序集所在的wwwroot目录并非同一路径，直接使用工作目录构造配置路径会指向错误位置。

修复方案 #

方案1：使用AppContext.BaseDirectory获取可靠根目录 #

AppContext.BaseDirectory返回当前应用程序集所在目录，是.NET跨平台获取应用根目录的标准方式：

var basePath = AppContext.BaseDirectory;
var configuration = new ConfigurationBuilder()
    .SetBasePath(basePath)
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables()
    .Build();

方案2：通过程序集路径构造根目录 #

通过当前执行程序集的位置提取目录，同样保证跨平台兼容性：

var assemblyLocation = System.Reflection.Assembly.GetExecutingAssembly().Location;
var basePath = System.IO.Path.GetDirectoryName(assemblyLocation);
var configuration = new ConfigurationBuilder()
    .SetBasePath(basePath)
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables()
    .Build();

方案3：临时规范化路径分隔符（辅助验证） #

若需快速修复路径格式问题，可使用Path.GetFullPath()自动统一分隔符，但无法解决工作目录与应用目录不一致的核心问题：

var currentDir = Directory.GetCurrentDirectory();
var normalizedPath = System.IO.Path.GetFullPath(currentDir);
var configuration = new ConfigurationBuilder()
    .SetBasePath(normalizedPath)
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .Build();

验证步骤 #

1. 本地运行测试，确认配置文件加载正常；
2. 重新部署到Azure Functions Linux环境，检查启动日志确认路径格式统一、配置文件加载成功。

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