修改默认账单地址时出现 DbEntityValidationException

2026-10-24支付小周

结论

问题并非街道地址字段本身引起。保存地址时，Entity Framework 会验证整个 VirtoCommerce.Foundation.Customers.Model.Address 实体。此时实体的 Name 超过了 128 个字符，所以即使只修改 StreetAddress，SaveChanges() 仍然会失败。

单凭 stack trace 无法判断问题能否在全新的代码和数据库环境中复现。“clean build”只会清理编译产物，不会删除数据库中的旧地址数据，也不会重置运行时映射配置或浏览器提交的数据。billing address 和 shipping address 都出现了相同错误，排查时应先看两者共用的地址编辑、模型绑定和实体映射流程。

为什么修改街道地址会报 `Name` 错误

EF 保存标记为 Modified 的实体时，会验证实体上的全部约束，而不只是发生变化的属性。下面几种情况都可能导致这个错误：

数据库中原有地址的 Name 已超过 128 个字符。
AddressEditModel 转换为 Address 时，街道、公司名或其他长文本被错误地赋给了 Name。
页面中的 input name、隐藏字段或 JavaScript 绑定有误。
浏览器自动填充将长地址写入了 Name 对应的表单字段。
数据库字段长度与实体模型中的 [StringLength(128)] 或 Fluent API 配置不一致。
地址数据来自旧版本或外部导入流程，创建时没有经过相同的长度验证。

排查的第一步是确认失败实体中 Name 的实际内容。不能因为用户修改了街道地址，就直接判断街道字段有问题。

定位失败实体的实际数据

在调用 SaveChanges() 的位置捕获 DbEntityValidationException，记录实体类型、状态、属性名、错误信息，以及相关字段的实际长度：

using System;
using System.Data.Entity.Validation;
using System.Diagnostics;
using System.Linq;

try
{
    unitOfWork.Commit();
}
catch (DbEntityValidationException ex)
{
    foreach (var entityError in ex.EntityValidationErrors)
    {
        var entry = entityError.Entry;

        Debug.WriteLine(
            $"Entity: {entry.Entity.GetType().FullName}, State: {entry.State}");

        if (entry.Entity is VirtoCommerce.Foundation.Customers.Model.Address address)
        {
            Debug.WriteLine($"Address ID: {address.AddressId}");
            Debug.WriteLine($"Name length: {address.Name?.Length ?? 0}");
            Debug.WriteLine($"Name value: {address.Name}");
        }

        foreach (var validationError in entityError.ValidationErrors)
        {
            Debug.WriteLine(
                $"Property: {validationError.PropertyName}, " +
                $"Error: {validationError.ErrorMessage}");
        }
    }

    throw;
}

生产环境中不要无条件记录完整地址、姓名等个人信息。通常只需记录地址 ID、字段长度和脱敏后的内容。

还需要在 AccountController.AddressEdit 中，分别检查模型映射前后的值：

Debug.WriteLine($"Input Name length: {model.Name?.Length ?? 0}");
Debug.WriteLine($"Input StreetAddress length: {model.StreetAddress?.Length ?? 0}");

// 执行 AddressEditModel -> Address 的映射

Debug.WriteLine($"Mapped Name length: {address.Name?.Length ?? 0}");
Debug.WriteLine($"Mapped StreetAddress length: {address.StreetAddress?.Length ?? 0}");

如果 model.Name 正常，但映射后的 address.Name 变长，问题就在映射逻辑中。如果请求模型里的 Name 已经异常，则应继续检查页面表单、JavaScript 和浏览器提交的请求负载。

检查表单和映射代码

确认街道输入框绑定的是街道字段，而不是 Name：

@Html.TextBoxFor(x => x.StreetAddress)
@Html.ValidationMessageFor(x => x.StreetAddress)

@Html.TextBoxFor(x => x.Name)
@Html.ValidationMessageFor(x => x.Name)

检查生成后的 HTML，确保字段名没有混淆：

<input name="StreetAddress" ...>
<input name="Name" ...>

接着检查 AddressEditModel 到实体的赋值代码或 AutoMapper 配置。手动映射时，字段含义应保持一致：

address.Name = model.Name;
address.StreetAddress = model.StreetAddress;
address.City = model.City;
address.PostalCode = model.PostalCode;

尤其要排查下面这种错误：

// 错误示例：把完整地址写入了 Name
address.Name = model.StreetAddress;

还要检查是否存在拼接逻辑：

address.Name = string.Join(
    ", ",
    model.Name,
    model.StreetAddress,
    model.City,
    model.PostalCode);

这样的拼接结果很容易超过 128 个字符。

检查数据库中的历史数据

先确认地址表的实际名称和字段，再查询超长数据。SQL Server 可以使用：

SELECT
    AddressId,
    LEN([Name]) AS NameLength,
    [Name]
FROM [Address]
WHERE LEN([Name]) > 128;

如果实际表名包含 schema 或使用了其他名称，需要按照 EF 映射调整查询。

还应检查数据库列的定义：

SELECT
    COLUMN_NAME,
    DATA_TYPE,
    CHARACTER_MAXIMUM_LENGTH
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'Address'
  AND COLUMN_NAME = 'Name';

即使数据库允许写入超过 128 个字符的内容，EF 也不一定接受。实体上的 Data Annotation 或 Fluent API 仍可能在数据写入数据库前阻止保存。

如果超长值来自历史数据，应先弄清 Name 的业务含义，再选择修复方式。可以人工清理，也可以编写一次性迁移，但不要在没有备份的情况下直接批量截断。只有确认允许截断后，才可执行：

UPDATE [Address]
SET [Name] = LEFT([Name], 128)
WHERE LEN([Name]) > 128;

如果 Name 保存的是用户姓名、公司名或地址标签，直接截断可能造成数据丢失，也可能产生重复名称。

在输入层增加一致的验证

如果业务规则明确要求最多 128 个字符，页面模型应与实体使用相同的限制：

using System.ComponentModel.DataAnnotations;

public class AddressEditModel
{
    [StringLength(128, ErrorMessage = "名称不能超过 128 个字符。")]
    public string Name { get; set; }

    public string StreetAddress { get; set; }
}

控制器必须在映射和保存前检查 ModelState：

[HttpPost]
public ActionResult AddressEdit(AddressEditModel model)
{
    if (!ModelState.IsValid)
    {
        return View(model);
    }

    // 查询并更新地址实体
    // 保存修改

    return RedirectToAction("AddressBook");
}

业务层也可以增加防御性检查，避免其他入口绕过 MVC 验证：

if (!string.IsNullOrEmpty(address.Name) && address.Name.Length > 128)
{
    throw new ValidationException(
        $"Address.Name contains {address.Name.Length} characters; maximum is 128.");
}

如何验证是否为环境或代码问题

可以分别测试以下场景：

使用全新编译结果和现有数据库编辑地址。
使用同一份代码连接全新数据库，创建新用户和新地址后再编辑。
关闭浏览器自动填充，或在无痕窗口中重新提交。
对比 billing 和 shipping 请求的表单负载及映射结果。
直接查看失败地址保存前的 Name 值和长度。

如果问题只在现有数据库中出现，通常与历史数据有关。如果连接全新数据库后仍能稳定复现，更可能是表单绑定、共享映射或初始化代码的问题。如果只有特定用户遇到错误，应重点检查该用户已有的地址记录。

修复的重点不是扩大街道字段长度，而是查明 Address.Name 为什么会超过 128 个字符。只有确认业务确实需要更长的名称，才应同时修改实体约束、数据库 schema、输入模型和相关 API 合约。