EF Core scaffolding外键类型不匹配错误，数据库正常应如何修复？

错误根因 #

实体类型“JobAdvert”上为外键 {'CityId'} 指定的属性类型，与实体类型“City”上的主键 {'Id'} 的属性类型不匹配

由提供的表结构可定位问题：public.cities表的主键id为smallint类型，public.job_adverts表中关联的外键city_id为integer类型。即使数据库层面可通过NOT VALID约束绕过类型校验正常运行，EF Core脚手架生成实体时仍会强制校验关联键类型一致性，因此触发该报错。

修复方案 #

方案1：修改数据库表结构（推荐） #

统一关联键类型可从根源解决问题，同时避免后续业务逻辑出现类型转换隐患，可选以下任意一种修改方向：

• 将cities表的id字段改为integer类型，与city_id类型对齐

  -- 先删除原有外键约束
  ALTER TABLE public.job_adverts DROP CONSTRAINT job_adverts_city_id_fkey;
  -- 修改cities表主键字段类型
  ALTER TABLE public.cities ALTER COLUMN id TYPE integer;
  -- 重新创建外键约束
  ALTER TABLE public.job_adverts ADD CONSTRAINT job_adverts_city_id_fkey 
    FOREIGN KEY (city_id) REFERENCES public.cities (id) 
    MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION;
  

• 或将job_adverts表的city_id字段改为smallint类型，与cities.id类型对齐

  -- 先删除原有外键约束
  ALTER TABLE public.job_adverts DROP CONSTRAINT job_adverts_city_id_fkey;
  -- 修改job_adverts表外键字段类型
  ALTER TABLE public.job_adverts ALTER COLUMN city_id TYPE smallint;
  -- 重新创建外键约束
  ALTER TABLE public.job_adverts ADD CONSTRAINT job_adverts_city_id_fkey 
    FOREIGN KEY (city_id) REFERENCES public.cities (id) 
    MATCH SIMPLE ON UPDATE NO ACTION ON DELETE NO ACTION;
  

修改完成后重新执行scaffold命令即可正常生成实体。

方案2：不修改数据库，手动配置映射规则 #

若确实无法修改现有库表结构，可通过调整脚手架配置和手动补充映射规则解决问题：

1. 执行scaffold命令时添加--no-foreign-keys参数，忽略外键约束先生成基础实体
2. 在DbContext的OnModelCreating方法中手动补充关联配置，显式指定类型转换：

   // 配置CityId类型转换
   modelBuilder.Entity<JobAdvert>()
       .Property(x => x.CityId)
       .HasConversion<short>();
   
   // 配置两张表的关联关系
   modelBuilder.Entity<JobAdvert>()
       .HasOne<City>(x => x.City)
       .WithMany()
       .HasForeignKey(x => x.CityId);
   

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