ASP.NET MVC控制器访问文件路径报错，咨询读取文件的最佳实践

一、路径错误的解决方法 #

你遇到的DirectoryNotFoundException是因为相对路径的基准目录并非项目目录：ASP.NET MVC运行时默认工作目录是IIS的系统目录（c:\windows\system32\inetsrv），直接使用相对路径会导致程序去错误的目录查找文件。

针对不同的.NET框架版本，有两种可靠的解决方式：

1. ASP.NET Framework（.NET Framework） #

使用Server.MapPath将项目根路径标识~/转换为服务器绝对物理路径：

string filePath = Server.MapPath("~/Areas/Communications/Data/Codes.json");
using (var reader = new StreamReader(filePath))
{
    // 执行文件读取操作
}

~/代表项目根目录，Server.MapPath会自动将其转换为服务器上的真实物理路径，确保能定位到目标JSON文件。

2. ASP.NET Core MVC #

通过依赖注入IWebHostEnvironment获取项目内容根路径，再拼接目标文件路径：

private readonly IWebHostEnvironment _webHostEnv;

// 构造函数注入IWebHostEnvironment
public MyController(IWebHostEnvironment webHostEnv)
{
    _webHostEnv = webHostEnv;
}

// 在方法中使用
string filePath = Path.Combine(_webHostEnv.ContentRootPath, "Areas/Communications/Data/Codes.json");
using (var reader = new StreamReader(filePath))
{
    // 执行文件读取操作
}

二、控制器直接读取文件的最佳实践分析 #

直接在控制器中读取文件不是最佳实践，主要问题包括：

• 违反单一职责原则：控制器的核心职责是处理请求、协调业务逻辑、返回响应，直接操作文件会让控制器职责混杂，代码臃肿。
• 可测试性差：硬编码文件路径、直接操作IO的代码无法通过单元测试模拟，难以验证逻辑正确性。
• 复用性低：其他组件需要读取该文件时，只能重复编写相同的路径拼接和IO代码。

更优的实现方案 #

将文件读取逻辑封装为独立服务，通过依赖注入供控制器调用：

1. 定义数据读取接口

public interface ICodeDataService
{
    // 可根据JSON结构返回强类型对象，示例以返回字符串为例
    Task<string> GetCodeDataAsync();
}

2. 实现服务类

public class CodeDataService : ICodeDataService
{
    private readonly HttpContextBase _httpContext;

    public CodeDataService(HttpContextBase httpContext)
    {
        _httpContext = httpContext;
    }

    public async Task<string> GetCodeDataAsync()
    {
        string filePath = _httpContext.Server.MapPath("~/Areas/Communications/Data/Codes.json");
        using (var reader = new StreamReader(filePath))
        {
            return await reader.ReadToEndAsync();
        }
    }
}

3. 控制器注入并使用服务

public class MyController : Controller
{
    private readonly ICodeDataService _codeDataService;

    public MyController(ICodeDataService codeDataService)
    {
        _codeDataService = codeDataService;
    }

    public async Task<ActionResult> Index()
    {
        string codeData = await _codeDataService.GetCodeDataAsync();
        // 处理数据并返回视图
        return View();
    }
}

这种方式不仅解耦了控制器与IO操作，还方便后续更换数据源（比如从数据库读取），只需修改服务实现即可，无需改动控制器代码。

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