Azure App Service中调用File.Replace抛出IOException问题求助

问题详情 #

部署在Azure App Service的代码调用以下方法替换临时文件夹文件：

File.Replace("c:\local\temp\source.pdf", "c:\local\temp\destination.pdf", "c:\local\temp\original.pdf", false)

该代码正常运行多年后，几周前开始抛出异常：

System.IO.IOException: Unable to remove the file to be replaced.
at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
at System.IO.File.InternalReplace(String sourceFileName, String destinationFileName, String destinationBackupFileName, Boolean ignoreMetadataErrors)

通过Kudu控制台执行PowerShell命令复现同样错误：

[System.IO.File]::Replace("c:\local\temp\source.pdf", "c:\local\temp\destination.pdf", "c:\local\temp\original.pdf", $false)

同一App Service计划下的所有应用均出现此问题，更换到其他计划则正常，调整计划规模无法解决，已提交微软支持工单暂未得到解决。

可行解决方案尝试 #

1. 手动实现文件替换逻辑 #

绕过File.Replace()的系统级调用，拆分操作步骤，避免底层API的潜在限制：

// 备份目标文件（覆盖已存在的备份）
File.Copy("c:\local\temp\destination.pdf", "c:\local\temp\original.pdf", overwrite: true);
// 删除原目标文件
File.Delete("c:\local\temp\destination.pdf");
// 将源文件移动到目标路径
File.Move("c:\local\temp\source.pdf", "c:\local\temp\destination.pdf");

建议添加重试机制，处理文件临时被锁定的场景。

2. 检查文件占用情况 #

通过Kudu控制台使用handle.exe工具排查是否有进程占用目标文件：

# 下载handle工具
Invoke-WebRequest -Uri https://download.sysinternals.com/files/Handle.zip -OutFile Handle.zip
Expand-Archive Handle.zip -DestinationPath .
# 检查目标文件的占用进程
.\handle.exe c:\local\temp\destination.pdf

若发现异常占用，可尝试重启App Service释放资源。

3. 更换临时存储路径 #

避免使用c:\local\temp，改用App Service中权限更稳定的存储路径：

• D:\home\site\wwwroot\temp：网站根目录下的自定义临时文件夹
• 通过echo %TEMP%查看的系统临时路径

修改代码中的文件路径后重新测试。

4. 对比计划配置差异 #

排查异常计划与正常计划的配置区别，重点关注：

• Windows Server操作系统版本是否有更新
• 是否启用了新的文件系统安全限制策略
• 站点是否安装了可能影响文件操作的扩展组件

5. 替换为Azure Blob存储操作 #

若业务场景允许，将文件存储迁移到Azure Blob Storage，通过Blob的复制、删除操作替代本地文件替换，规避App Service本地文件系统的限制。

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