.NET 6搭配React实现图片上传入库时字段为空问题排查

你查询时看到imageFile列值为null是完全符合代码预期的正常现象，不属于功能bug：

• 你在ImageFile属性上标注了[NotMapped]特性，该特性会明确告知EF Core：这个属性不参与数据库表字段映射，所有数据库增删改查操作都会自动忽略这个属性，不会对它做任何读写。
• ImageFile属性的作用仅仅是作为模型绑定的载体，接收前端上传过来的文件流，本身不需要持久化到数据库。你设计的Picture字段存储图片文件名的方案是合理的，只要确认Picture列成功写入了生成的图片文件名，上传存储功能就已经正常运行。
• 如果你的数据库表中确实存在imageFile列，属于早期实体未加[NotMapped]时执行迁移遗留的冗余字段，EF Core不会维护这个字段的数据，永远为null是正常的，可以在新的迁移中删除该冗余列避免误解。

虽然核心功能逻辑没问题，但现有代码存在几个容易引发运行异常的点，可以调整：

1. 缺少空值校验
   你的SaveImage方法没有判断上传文件是否为空，如果前端未传文件，访问imageFile.FileName会直接抛出空引用异常，建议增加判断：

   [NonAction]
   public async Task<string> SaveImage(IFormFile imageFile)
   {
       if (imageFile == null || imageFile.Length == 0)
       {
           // 可根据业务需求返回默认头像路径，或抛出业务异常
           return "default-avatar.png";
       }
       // 原有逻辑保留
       string imageName = new String(Path.GetFileNameWithoutExtension(imageFile.FileName)
               .Take(10).ToArray()).Replace(' ', '-');
       imageName = imageName + DateTime.Now.ToString("yymmssfff") + Path.GetExtension(imageFile.FileName);
   
       var imagePath = Path.Combine(_hostEnvironment.WebRootPath, "Images", imageName);
       
       // 新增：自动创建不存在的目录，避免首次运行抛出目录不存在异常
       var imageDir = Path.GetDirectoryName(imagePath);
       if (!Directory.Exists(imageDir))
       {
           Directory.CreateDirectory(imageDir);
       }
   
       using (var fileStream = new FileStream(imagePath, FileMode.Create))
       {
           await imageFile.CopyToAsync(fileStream);
       }
   
       return imageName;
   }
   

2. 存储路径选择问题
   你当前把图片存在ContentRootPath（项目根目录）下的Images文件夹，.NET默认的静态文件中间件只会对外提供wwwroot目录下的文件访问能力，如果要让前端能正常访问到上传的图片，有两个方案：
   • 方案一：把存储路径改到_hostEnvironment.WebRootPath下的Images文件夹，也就是上面代码示例中的写法，同时在Program.cs中开启静态文件中间件：

     var app = builder.Build();
     // 放在路由、授权等中间件之前
     app.UseStaticFiles();
     

   • 方案二：保留现有存储路径，额外配置自定义静态文件目录：

     app.UseStaticFiles(new StaticFileOptions
     {
         FileProvider = new PhysicalFileProvider(
             Path.Combine(builder.Environment.ContentRootPath, "Images")),
         RequestPath = "/Images"
     });
     

3. 数据库迁移同步
   如果你调整过实体字段配置，记得执行Add-Migration 迁移描述和Update-Database命令，保证表结构和实体配置一致，避免出现字段约束不匹配导致的写入失败。

• 前端上传时不要用JSON格式传参，需要用FormData对象包装所有普通参数和文件，发送请求时不要手动设置Content-Type请求头，让浏览器自动生成带boundary的multipart/form-data头，否则后端模型绑定会失败。
• 生产环境不建议把图片存在应用本地目录，应用重新部署、重启或者多实例部署时很容易出现文件丢失、不同实例文件不一致的问题，优先使用云厂商的对象存储服务存放文件，数据库只存文件访问路径即可。
• 不推荐把图片二进制内容直接存入数据库，大文件存入数据库会大幅提升数据库查询压力，性能远低于文件存储+数据库存路径的方案。如果确实有存库需求，需要用byte[]类型作为属性类型，添加[Column(TypeName = "varbinary(max)")]特性映射对应字段。

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