在nopCommerce中为Category表添加CategoryType字段失败，报错列不存在

问题背景 #

按照nopCommerce开发者教程步骤，尝试给Category表添加CategoryType字段，完成所有操作后，数据库未生成对应字段，且运行时抛出错误：

An unhandled exception occurred while processing the request.
SqlException: Invalid column name 'CategoryType'.

已执行的操作步骤如下：

步骤1：在Core层实体类添加字段 #

修改Nop.Core.Domain.Catalog.Category.cs，新增CategoryType属性：

namespace Nop.Core.Domain.Catalog
{
    /// <summary>
    /// Represents a category
    /// </summary>
    public partial class Category : BaseEntity, ILocalizedEntity, ISlugSupported, IAclSupported, IStoreMappingSupported, IDiscountSupported<DiscountCategoryMapping>, ISoftDeletedEntity
    {
        public string CategoryType { get; set; }
        /// <summary>
        /// Gets or sets the name
        /// </summary>
        public string Name { get; set; }

        /// <summary>
        /// Gets or sets the description
        /// </summary>
    }
}

步骤2：配置实体映射 #

修改Nop.Data.Mapping.Builders.Catalog.CategoryBuilder.cs，映射CategoryType列：

public override void MapEntity(CreateTableExpressionBuilder table)
{
    table
        .WithColumn(nameof(Category.CategoryType)).AsString(400).NotNullable()
        .WithColumn(nameof(Category.Name)).AsString(400).NotNullable()
        .WithColumn(nameof(Category.MetaKeywords)).AsString(400).Nullable()
        .WithColumn(nameof(Category.MetaTitle)).AsString(400).Nullable()
        .WithColumn(nameof(Category.PageSizeOptions)).AsString(200).Nullable();
}

步骤3：创建迁移类 #

在Nop.Data.Migrations命名空间下创建AddCategoryType.cs迁移类：

public class AddCategoryType : AutoReversingMigration
{
    //Add migration for Add Category Type in Category table.
    public override void Up()
    {
        Create.Column(nameof(Category.CategoryType))
         .OnTable(nameof(Category))
         .AsString(255)
         .Nullable();
    }
}

步骤4：添加验证逻辑 #

在Nop.Web.Areas.Admin.Validators.Catalog命名空间下新增CategoryValidator.cs：

public partial class CategoryValidator : BaseNopValidator<CategoryModel>
{
    public CategoryValidator(ILocalizationService localizationService, IMappingEntityAccessor mappingEntityAccessor)
    {
        RuleFor(x => x.CategoryType).Length(0, 255);
        RuleFor(x => x.CategoryType).NotEmpty().WithMessageAwait(localizationService.GetResourceAsync("Admin.Catalog.Categories.Fields.CategoryType.Required"));
    }
}

步骤5：添加模型属性 #

修改Nop.Web.Areas.Admin.Models.Catalog.CategoryModel.cs，新增CategoryType属性：

public partial record CategoryModel 
{
    [NopResourceDisplayName("Admin.Catalog.Categories.Fields.CategoryType")]
    public string CategoryType { get; set; }
}

步骤6：修改后台视图 #

在nop.Web.Areas.Admin.Views.Category._CreateOrUpdate.Info.cshtml中添加字段显示：

@model CategoryModel

<div class="card-body">
    @(await Html.LocalizedEditorAsync<CategoryModel, CategoryLocalizedModel>("category-name-localized",
        @<div>
<div class="form-group row">
            <div class="col-md-3">
                <nop-label asp-for="CategoryType" />
            </div>
            <div class="col-md-9">
                <nop-editor asp-for="CategoryType" asp-required="true" />
                <span asp-validation-for="CategoryType"></span>
            </div>
        </div>
        <div class="form-group row">
            <div class="col-md-3">
                <nop-label asp-for="Description" />
            </div>
            <div class="col-md-9">
                <nop-editor asp-for="Description" asp-template="RichEditor" />
                <span asp-validation-for="Description"></span>
            </div>
        </div>
    </div>))
</div>

问题分析与解决方案 #

1. 迁移类与实体映射的配置不一致 #

CategoryBuilder中配置CategoryType为AsString(400).NotNullable()，但迁移类中是AsString(255).Nullable()，两者定义冲突会导致迁移执行异常或字段未正确创建。
解决：统一两处配置，比如都改为AsString(400).Nullable()（或根据需求调整为一致的长度和可空性），确保迁移类和实体映射的定义完全匹配。

2. 迁移未正确执行 #

• 打开Package Manager Console，执行Get-Migrations命令查看已应用和未应用的迁移列表。
• 如果AddCategoryType未被应用，执行Update-Database命令手动应用迁移。
• 若使用命令行工具，运行dotnet ef migrations list和dotnet ef database update来检查和应用迁移。

3. 确保实体映射被正确加载 #

检查CategoryBuilder是否被正确注册到实体配置中，nopCommerce会自动扫描Mapping.Builders下的构建类，若为手动添加的类，需确认没有命名空间或程序集引用问题。

4. 清理缓存并重启应用 #

nopCommerce使用缓存机制，修改实体和映射后需清理应用缓存（后台系统设置中的缓存清理选项），并重启应用程序，确保新的实体定义被加载。

5. 验证资源文件是否存在 #

验证中使用了资源字符串Admin.Catalog.Categories.Fields.CategoryType.Required，需确保对应的语言资源文件中存在该键值，否则可能导致验证逻辑异常，间接影响实体的正常映射。

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