.NET Core API部署Azure App Service后无法写入文件报500错误求助

问题背景 #

.NET Core应用在本地或第三方服务器运行时，可正常编辑wwwroot文件夹内文件，但部署到Azure App Service后，操作文件时触发500错误。相关代码涉及从Azure Blob存储下载.rdlc文件到本地临时目录，再用于生成PDF报表。

代码问题分析 #

从提供的代码来看，核心问题集中在以下几点：

1. 异步调用阻塞：DownloadToStreamAsync(fileStream).Wait()用同步阻塞方式等待异步操作，在ASP.NET Core环境下极易引发死锁，导致请求超时或直接抛出500错误。
2. 临时文件冲突：多个请求共用同一个临时文件路径prescription.rdl，会出现文件占用冲突，导致写入失败。
3. 异常信息缺失：catch块仅直接抛出异常，未记录具体错误细节，无法定位是权限问题、文件占用还是其他操作失败。

解决方案 #

1. 修复异步调用逻辑 #

将同步阻塞的Wait()改为异步等待，避免死锁：

public static async Task DownloadRdlcFileFromAzureStorage(string connectionString, string containerName, string blobName, string localFilePath)
{
    CloudStorageAccount storageAccount = CloudStorageAccount.Parse(connectionString);
    CloudBlobClient blobClient = storageAccount.CreateCloudBlobClient();
    CloudBlobContainer container = blobClient.GetContainerReference(containerName);
    CloudBlockBlob blob = container.GetBlockBlobReference(blobName);

    // 确保目标目录存在
    Directory.CreateDirectory(Path.GetDirectoryName(localFilePath));
    
    using (var fileStream = File.OpenWrite(localFilePath))
    {
        await blob.DownloadToStreamAsync(fileStream);
    }
}

调用处同步改为异步：

await QRCodeGeneratorHelper.DownloadRdlcFileFromAzureStorage(connectionString, containerName, blobName, localRdlcFilePath);

2. 生成唯一临时文件路径 #

避免多请求文件冲突，生成全局唯一的临时文件名：

// 用GUID生成唯一文件名，防止并发请求冲突
var uniqueFileName = $"prescription_{Guid.NewGuid()}.rdl";
var localRdlcFilePath = Path.Combine(Path.GetTempPath(), uniqueFileName);

3. 完善异常捕获与日志 #

在catch块中记录详细异常信息，便于精准排查：

catch (Exception ex)
{
    // 用日志框架记录完整异常（如Serilog、NLog）
    // _logger.LogError(ex, "PDF报表生成失败，路径：{Path}", localRdlcFilePath);
    // 返回明确错误信息，而非直接抛出500
    return StatusCode(StatusCodes.Status500InternalServerError, $"报表生成失败：{ex.Message}");
}

4. 验证Azure App Service配置 #

• Azure App Service的临时目录（Path.GetTempPath()指向路径）默认具备写入权限，但需确保应用运行在基本/标准/高级层级（免费层存在更多资源限制）。
• 若需操作wwwroot目录：Azure App Service的wwwroot默认只读，如需写入需启用本地缓存，或直接改用Azure存储存储可编辑文件。

5. 跳过磁盘文件操作（可选优化） #

直接将.rdlc文件下载到内存流，避免磁盘IO和文件占用问题：

// 直接下载到内存流，无需写入磁盘
using (var memoryStream = new MemoryStream())
{
    await blob.DownloadToStreamAsync(memoryStream);
    memoryStream.Position = 0;
    LocalReport localReport = new LocalReport(memoryStream);
    // 后续报表生成逻辑...
}

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