CoreData添加实体报错：找不到NSEntityDescription与子类匹配的解决方法

针对你遇到的CoreData: error: +[CountryEntity entity] Failed to find a unique match for an NSEntityDescription to a managed object subclass报错，以下是具体解决步骤：

1. 修正实体名称与代码类名的匹配问题 #

从你的数据模型截图可以看到，实体的名称是Country，但你代码中全程使用CountryEntity作为类名和实体查询标识（比如NSFetchRequest<CountryEntity>(entityName: "CountryEntity")、CountryEntity(context: ...)）。CoreData要求实体名称和对应的NSManagedObject子类名称必须严格对应，否则无法完成映射。

解决方式二选一：

• 打开数据模型文件，将实体名称从Country修改为CountryEntity，并确保实体的「Class」字段设置为CountryEntity（模块选择当前项目）；
• 将代码中的所有CountryEntity替换为Country，同时确保数据模型中实体的「Class」字段设置为Country。

2. 确保NSManagedObject子类生成正确 #

如果你是手动编写的CountryEntity类，很可能缺少CoreData所需的映射标记。建议用Xcode自动生成子类：

1. 选中你的.xcdatamodeld文件；
2. 顶部菜单栏选择Editor > Create NSManagedObject Subclass...；
3. 按照向导选择对应的实体和目标位置，生成的类会自动包含@objc(XXX)等必要标记，确保CoreData能正确识别。

3. 清理项目缓存并重建 #

Xcode的缓存可能导致模型与类的映射异常，执行以下操作：

• 选择Product > Clean Build Folder（快捷键：Cmd+Shift+K）；
• 关闭Xcode，删除DerivedData文件夹（路径：~/Library/Developer/Xcode/DerivedData）；
• 重新打开项目并构建运行。

4. 验证PersistentContainer名称与模型文件名一致 #

你的代码中使用NSPersistentContainer(name: "CountryCoreData")，需要确保你的数据模型文件名是CountryCoreData.xcdatamodeld，如果文件名不匹配，容器无法加载正确的模型文件，也会导致实体映射失败。

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