ASP.NET Core Web API中Get请求ICollection<T>非空显示及字段空值问题

问题原因 #

你在EstadoController的查询里，虽然用Include(x => x.Municipios)加载了关联的Municipio集合，但Municipio模型里的Estado导航属性没被加载（EF Core默认不会自动加载深层关联），而且EstadoDto直接引用Municipio实体模型而非DTO，导致序列化后Estado字段为null，同时还可能触发循环引用问题（Estado包含Municipios，Municipio又包含Estado）。

解决方案 #

1. 修改EstadoDto，用嵌套DTO替代实体模型 #

把EstadoDto中的Municipios类型改成ICollection<MunicipioDto>，避免直接引用实体：

using AppEstados.DTOs;
using System.ComponentModel.DataAnnotations;

namespace AppEstados.DTOs
{
    public class EstadoDto
    {
        public int Id { get; set; }

        [Required]
        public string? Nombre { get; set; }

        // 替换为MunicipioDto集合
        public ICollection<MunicipioDto>? Municipios { get; set; }
    }
}

2. 调整EstadoController的查询逻辑，手动映射嵌套数据 #

直接在查询的Select里完成DTO映射，不需要额外的Include（这种投影方式更高效，只拉取需要的字段）：

// GET: api/Estado
[HttpGet]
public async Task<ActionResult<IEnumerable<EstadoDto>>> GetEstados()
{              
    var listaEstados = await _context.Estados
                                     .Select(x => new EstadoDto
                                                  {
                                                      Id = x.Id,
                                                      Nombre = x.Nombre,
                                                      Municipios = x.Municipios.Select(m => new MunicipioDto
                                                      {
                                                          Id = m.Id,
                                                          Nombre = m.Nombre,
                                                          EstadoId = m.EstadoId,
                                                          Estado = x.Nombre // 直接用当前Estado的名称，无需额外加载
                                                      }).ToList()
                                                  })
                                     .ToListAsync();
            
    return listaEstados;
}

可选方案：用Include+ThenInclude加载深层关联 #

如果一定要用关联加载的方式，也可以这样写（但投影方式更推荐，因为不会加载冗余数据）：

// GET: api/Estado
[HttpGet]
public async Task<ActionResult<IEnumerable<EstadoDto>>> GetEstados()
{              
    var listaEstados = await _context.Estados
                                     .Include(x => x.Municipios)
                                         .ThenInclude(m => m.Estado) // 加载Municipio对应的Estado
                                     .Select(x => new EstadoDto
                                                  {
                                                      Id = x.Id,
                                                      Nombre = x.Nombre,
                                                      Municipios = x.Municipios.Select(m => new MunicipioDto
                                                      {
                                                          Id = m.Id,
                                                          Nombre = m.Nombre,
                                                          EstadoId = m.EstadoId,
                                                          Estado = m.Estado?.Nombre
                                                      }).ToList()
                                                  })
                                     .ToListAsync();
            
    return listaEstados;
}

注意事项 #

• 永远用DTO返回前端数据，不要直接返回实体模型，既能避免循环引用，还能减少不必要的数据传输。
• 投影方式（直接Select映射DTO）比Include加载整个实体更高效，建议优先使用。

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