使用DTO后接口返回500无法读取数据库数据，求排查解决

问题现象 #

不使用DTO时接口功能正常，引入DTO后接口始终返回500错误，无法从数据库获取数据。

相关代码 #

Controller #

[HttpGet("api/GetSubjectsJson")]
public async Task<IActionResult> GetSubjectsJson()
{
  var subjects = await _dataManager.GetSubjects();
  Console.WriteLine(subjects);
  return Json(subjects);
}

DataManager #

public async Task<List<LearningRecordsDto>> GetSubjects()
{
    var learningRecord = _context.LearningRecords.Select(lr => new  LearningRecordsDto
    {
        LearningRecordId = lr.Id,
        SubjectName = lr.Subject.Name,
        StudyDate = lr.StudyDate,
        learningStatus = lr.LearningStatus != null && !string.IsNullOrEmpty(lr.LearningStatus.Name) 
            ? (LearningStatus)Enum.Parse(typeof(LearningStatus), lr.LearningStatus.Name) 
            : default(LearningStatus)
    }).ToListAsync();
    return await learningRecord;
}

DTO #

public class LearningRecordsDto
{
    public int LearningRecordId { get; set; }
    public string? SubjectName { get; set; }
    public DateOnly StudyDate { get; set; }
    public LearningStatus learningStatus { get; set; }
}

问题分析 #

• Enum.Parse无法被EF Core解析：LINQ to Entities会尝试将查询转换为SQL语句，但Enum.Parse是.NET本地方法，EF Core无法将其翻译成对应的SQL，执行时会抛出异常。
• 导航属性未加载：lr.Subject和lr.LearningStatus是关联实体的导航属性，如果未显式使用Include加载，EF Core默认不会自动获取关联数据，访问lr.Subject.Name时会触发空引用异常。
• DateOnly类型兼容性问题：若数据库中StudyDate字段为DateTime类型，部分旧版本EF Core对DateOnly的映射支持不完善，可能导致转换失败。

解决方案 #

1. 调整枚举转换逻辑，避免在LINQ查询中使用无法解析的方法 #

先将数据查询到内存中，再进行枚举转换，这样就不会依赖EF Core的SQL转换：

public async Task<List<LearningRecordsDto>> GetSubjects()
{
    // 显式加载关联的导航属性
    var rawRecords = await _context.LearningRecords
        .Include(lr => lr.Subject)
        .Include(lr => lr.LearningStatus)
        .ToListAsync();

    // 在内存中转换为DTO并处理枚举
    return rawRecords.Select(lr => new LearningRecordsDto
    {
        LearningRecordId = lr.Id,
        SubjectName = lr.Subject?.Name,
        StudyDate = lr.StudyDate,
        learningStatus = lr.LearningStatus != null && !string.IsNullOrEmpty(lr.LearningStatus.Name) 
            ? Enum.TryParse<LearningStatus>(lr.LearningStatus.Name, out var status) ? status : default
            : default
    }).ToList();
}

2. 显式加载导航属性 #

使用Include方法确保EF Core加载关联的Subject和LearningStatus数据，避免空引用异常。

3. 处理DateOnly类型映射（若存在兼容性问题） #

如果数据库中StudyDate是DateTime类型，可手动转换为DateOnly：

StudyDate = DateOnly.FromDateTime(lr.StudyDate),

或者确保使用的EF Core版本为6.0及以上，该版本开始原生支持DateOnly类型映射。

4. 添加异常捕获排查具体错误 #

在Controller中增加异常捕获，输出详细错误信息，方便定位问题：

[HttpGet("api/GetSubjectsJson")]
public async Task<IActionResult> GetSubjectsJson()
{
    try
    {
        var subjects = await _dataManager.GetSubjects();
        Console.WriteLine(subjects);
        return Json(subjects);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"错误详情：{ex.ToString()}");
        return StatusCode(500, new { ErrorMessage = ex.Message });
    }
}

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