ASP.NET如何设置托管环境可用的文件路径而非依赖本地路径

问题根因 #

File.ReadAllLines方法的相对路径是相对于进程的工作目录解析，而非网站项目的根目录。你本地用的是系统绝对路径自然能读，但用/files/filename.txt这种写法时，进程工作目录和你项目根目录不匹配，自然找不到文件，后续404报错是文件读取失败触发的异常页，并非真的页面路径错误。

解决方案 #

第一步：配置文件复制属性 #

首先保证txt文件发布时会被同步到托管目录：
在VS解决方案资源管理器中找到files目录下的所有txt文件，右键点击「属性」，修改两个配置：

• 生成操作：设置为「内容」
• 复制到输出目录：设置为「如果较新则复制」

第二步：使用框架提供的根目录API拼接路径 #

不要手动硬写绝对/相对路径，用ASP.NET自带的站点根目录获取方法来生成完整物理路径：

如果你用的是ASP.NET Core

1. 先在控制器/服务中注入IWebHostEnvironment：

private readonly IWebHostEnvironment _webHostEnvironment;
// 构造函数注入
public YourController(IWebHostEnvironment webHostEnvironment)
{
    _webHostEnvironment = webHostEnvironment;
}

2. 读取文件时用Path.Combine拼接路径：

var fullFilePath = Path.Combine(_webHostEnvironment.WebRootPath, "files", "filename.txt");
var fileContent = File.ReadAllLines(fullFilePath);

如果你用的是ASP.NET Framework

直接用Server.MapPath方法获取物理路径：

var fullFilePath = HttpContext.Current.Server.MapPath("~/files/filename.txt");
var fileContent = File.ReadAllLines(fullFilePath);

注意事项 #

• 路径拼接必须用Path.Combine，不要手动拼接/或\，避免不同操作系统、不同托管环境的路径分隔符不兼容问题
• 路径开头用~代表站点根目录，不要用/开头，避免站点托管在子应用时路径解析错误
• 托管部署后要先检查站点部署目录下是否存在files文件夹和对应的txt文件，避免文件未同步导致的读取失败

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