元数据错误码（182*）

段位：182001 - 182999；当前 68 个；全部 V1 暴露

通用约定（HTTP status / code=1 兜底 / 响应结构）见 README

经 V1 元数据值读写（/v1/metadata/values/get / set / getBatch / batchSet）、资源表单 Schema（/v1/documents/getFormSchema / /v1/containers/getFormSchema）、字段定义查询（/v1/fieldDefinitions/get）、以及列表的元数据筛选条件校验（/v1/documents/getPage / /v1/containers/getPage）暴露。字段定义 / 受控词表 / 术语的建模管理（增删改、选项校验）已随建模域 V1 端点（/v1/fieldDefinitions/*、/v1/termSets/*、/v1/terms/*）开放，对应校验码 182050-182088 同样在 V1 暴露。将单个字段直接绑定到文档 / 容器实例（不经模板）的资源级字段直绑端点（/v1/resourceFieldBindings/*）另有一段专属校验码 182090-182096。

182001 METADATA_VALUE_VALIDATION_FAILED

• HTTP status：200
• 含义：元数据值写入校验失败
• 典型触发条件：/v1/metadata/values/set 写入时聚合的字段级校验失败（必填缺失 / 取值不合法 / 类型不匹配）
• 处理建议：按 msg 中聚合的字段错误逐项修正后重试；可先 getFormSchema 取字段约束
• 示例响应：

{ "code": 182001, "msg": "元数据校验失败", "data": null }

182002 METADATA_REQUIRED_FIELD_NO_CLEAR

• HTTP status：200
• 含义：必填字段不允许清空
• 典型触发条件：把必填字段置 null、增量操作后变为空、或显式删除其值
• 处理建议：必填字段须保留有效值；如需清空请先调整字段定义的必填约束（Console）
• 示例响应：

{ "code": 182002, "msg": "必填字段不允许清空", "data": null }

182003 METADATA_SINGLE_VALUE_NO_INCREMENTAL

• HTTP status：200
• 含义：单值字段不支持增量操作
• 典型触发条件：对单值字段使用 $add / $remove 增量操作符
• 处理建议：单值字段直接整体赋值；$add / $remove 仅用于多值字段
• 示例响应：

{ "code": 182003, "msg": "单值字段不支持增量操作", "data": null }

182004 METADATA_SINGLE_VALUE_NO_ARRAY

• HTTP status：200
• 含义：单值字段不允许提交数组
• 典型触发条件：给单值字段提交了数组值
• 处理建议：单值字段提交标量值；多值才用数组
• 示例响应：

{ "code": 182004, "msg": "单值字段不允许数组值", "data": null }

182005 METADATA_UNSUPPORTED_INCREMENTAL_OPERATOR

• HTTP status：200
• 含义：不支持的增量操作符
• 典型触发条件：增量对象里出现了 $add / $remove 以外的键
• 处理建议：增量操作仅支持 $add / $remove
• 示例响应：

{ "code": 182005, "msg": "不支持的增量操作符", "data": null }

182006 METADATA_INCREMENTAL_OPERAND_NOT_ARRAY

• HTTP status：200
• 含义：增量操作数必须为数组
• 典型触发条件：$add / $remove 的操作数不是数组
• 处理建议：$add / $remove 的值用数组承载，即使只有一个元素
• 示例响应：

{ "code": 182006, "msg": "$add / $remove 操作数必须为数组", "data": null }

182007 METADATA_DATE_FORMAT_INVALID

• HTTP status：200
• 含义：日期 / 日期时间格式不正确
• 典型触发条件：日期 / 日期时间字段的值不匹配受支持的格式
• 处理建议：按字段类型使用受支持的日期 / 日期时间格式提交
• 示例响应：

{ "code": 182007, "msg": "日期格式不正确", "data": null }

182008 DOCUMENT_NOT_FOUND

• HTTP status：200
• 含义：目标文档不存在
• 典型触发条件：按 docId 解析资源失败（元数据读写 / 表单 Schema / 文档生命周期等多处复用此码）
• 处理建议：核对 docId；文档可能已被删除或不在可见范围内
• 示例响应：

{ "code": 182008, "msg": "文档不存在", "data": null }

182009 CONTAINER_NOT_FOUND

• HTTP status：200
• 含义：目标容器不存在
• 典型触发条件：按 containerId 解析资源失败（元数据读写 / 表单 Schema / 容器与文档生命周期等多处复用此码）
• 处理建议：核对 containerId；容器可能已被删除或不在可见范围内
• 示例响应：

{ "code": 182009, "msg": "容器不存在", "data": null }

182010 UNSUPPORTED_RESOURCE_TYPE

• HTTP status：200
• 含义：资源类型暂不支持
• 典型触发条件：resourceType 非 DOCUMENT / CONTAINER
• 处理建议：元数据操作仅支持 DOCUMENT / CONTAINER
• 示例响应：

{ "code": 182010, "msg": "资源类型暂不支持", "data": null }

182011 RESOURCE_TYPE_NOT_ASSOCIATED

• HTTP status：200
• 含义：资源未关联内容类型
• 典型触发条件：目标资源未关联内容类型，无法解析字段 schema
• 处理建议：先为资源指定内容类型，再读写其元数据
• 示例响应：

{ "code": 182011, "msg": "资源未关联内容类型", "data": null }

182012 SENSITIVE_FIELD_OPERATION_FORBIDDEN

• HTTP status：200
• 含义：无权操作访问受控字段
• 典型触发条件：写入或清空「访问受控」字段的值，但调用方所代表的用户未获该字段的字段级「写」授权（受控字段在无授权时默认拒绝写入）。读取场景不报此错——无「读」授权时，该字段值在详情 / 列表 / 搜索结果中自动隐藏
• 处理建议：由管理方为该用户（或其角色 / 部门）在对应资源或其上级容器上授予该字段的写权限后重试；在上级容器授予一次即对其下所有内容生效
• 示例响应：

{ "code": 182012, "msg": "无权操作受控字段: 客户等级", "data": null }

182013 FIELD_DEFINITION_NOT_FOUND

• HTTP status：200
• 含义：字段定义不存在
• 典型触发条件：/v1/fieldDefinitions/get 等解析字段定义失败
• 处理建议：核对字段标识（attributeKey / fieldId）；字段可能未创建、已删除、或标识拼写错误
• 示例响应：

{ "code": 182013, "msg": "字段定义不存在", "data": null }

182014 METADATA_FILTER_TYPE_REQUIRED

• HTTP status：200
• 含义：使用元数据筛选时必须指定内容类型
• 典型触发条件：getPage 带元数据筛选条件，但未指定内容类型
• 处理建议：元数据筛选需限定到具体内容类型（字段集合随类型确定）
• 示例响应：

{ "code": 182014, "msg": "元数据筛选必须指定内容类型", "data": null }

182015 METADATA_FILTER_ATTRIBUTE_KEY_REQUIRED

• HTTP status：200
• 含义：筛选条件的 attributeKey 不能为空
• 典型触发条件：筛选条件缺少 attributeKey
• 处理建议：每个筛选条件须指定要筛选的字段 attributeKey
• 示例响应：

{ "code": 182015, "msg": "筛选字段不能为空", "data": null }

182016 METADATA_FILTER_OPERATOR_REQUIRED

• HTTP status：200
• 含义：筛选条件的 operator 不能为空
• 典型触发条件：筛选条件缺少 operator
• 处理建议：每个筛选条件须指定操作符（如 EQ / IN / RANGE / PREFIX / CONTAINS）
• 示例响应：

{ "code": 182016, "msg": "筛选操作符不能为空", "data": null }

182017 METADATA_FILTER_FIELD_UNSUPPORTED

• HTTP status：200
• 含义：筛选字段不在该类型的字段集合内
• 典型触发条件：筛选的 attributeKey 不属于所选内容类型的字段
• 处理建议：仅按该内容类型已定义的字段筛选
• 示例响应：

{ "code": 182017, "msg": "不支持的筛选字段", "data": null }

182018 METADATA_FILTER_OPERATOR_FIELD_TYPE_UNSUPPORTED

• HTTP status：200
• 含义：操作符与字段类型不兼容
• 典型触发条件：操作符与字段类型不匹配（PREFIX / CONTAINS 仅 STRING、RANGE 不支持选项 / 枚举类型、IN 不支持 BOOLEAN）
• 处理建议：按字段类型选用兼容的操作符
• 示例响应：

{ "code": 182018, "msg": "操作符与字段类型不兼容", "data": null }

182019 METADATA_FILTER_VALUES_REQUIRED

• HTTP status：200
• 含义：IN 操作符需要提供 values
• 典型触发条件：使用 IN 但未提供 values 列表
• 处理建议：IN 操作符须提供非空的 values 列表
• 示例响应：

{ "code": 182019, "msg": "IN 操作符需要 values 列表", "data": null }

182020 METADATA_FILTER_RANGE_BOUND_REQUIRED

• HTTP status：200
• 含义：RANGE 操作符需要边界
• 典型触发条件：使用 RANGE 但 rangeFrom 与 rangeTo 均未提供
• 处理建议：RANGE 至少提供 rangeFrom 或 rangeTo 之一
• 示例响应：

{ "code": 182020, "msg": "RANGE 操作符需要 rangeFrom 或 rangeTo", "data": null }

182021 METADATA_FILTER_VALUE_REQUIRED

• HTTP status：200
• 含义：筛选值不能为空
• 典型触发条件：筛选条件缺少筛选值
• 处理建议：提供非空的筛选值
• 示例响应：

{ "code": 182021, "msg": "筛选值不能为空", "data": null }

182022 METADATA_FILTER_VALUE_TYPE_MISMATCH

• HTTP status：200
• 含义：筛选值与字段类型不匹配
• 典型触发条件：筛选值不符合字段类型要求（需整数 / 数值 / 布尔 / 日期 / 日期时间格式）
• 处理建议：按字段类型提供匹配格式的筛选值
• 示例响应：

{ "code": 182022, "msg": "筛选值与字段类型不匹配", "data": null }

182050 ATTRIBUTE_KEY_EXISTS

• HTTP status：200
• 含义：属性键名已存在
• 典型触发条件：/v1/fieldDefinitions/save 新建字段定义时，attributeKey 与已有字段重复
• 处理建议：属性键在租户内须唯一，换用未被占用的 attributeKey
• 示例响应：

{ "code": 182050, "msg": "属性键名已存在", "data": null }

182051 SYSTEM_FIELD_NO_DELETE

• HTTP status：200
• 含义：系统字段不可删除
• 典型触发条件：/v1/fieldDefinitions/delete 删除平台内置的系统字段
• 处理建议：系统字段为平台内置、不支持删除；仅自定义字段可删除
• 示例响应：

{ "code": 182051, "msg": "系统字段不可删除", "data": null }

182052 FIELD_REFERENCED_BY_TEMPLATE

• HTTP status：200
• 含义：字段已被模板引用，无法删除
• 典型触发条件：/v1/fieldDefinitions/delete 删除仍被一个或多个模板引用的字段
• 处理建议：先从引用该字段的模板中移除此字段，再删除字段定义
• 示例响应：

{ "code": 182052, "msg": "字段已被模板引用，无法删除", "data": null }

182053 FIELD_BOUND_BY_TYPE

• HTTP status：200
• 含义：字段已被内容类型直接绑定，无法删除
• 典型触发条件：/v1/fieldDefinitions/delete 删除仍被内容类型直接绑定的字段
• 处理建议：先解除该字段与内容类型的绑定，再删除字段定义
• 示例响应：

{ "code": 182053, "msg": "字段已被类型绑定，无法删除", "data": null }

182054 FIELD_DEFAULT_VALUE_TYPE_MISMATCH

• HTTP status：200
• 含义：默认值与字段类型不匹配
• 典型触发条件：/v1/fieldDefinitions/save / update 设置的默认值类型与字段类型不符
• 处理建议：按字段类型提供匹配类型的默认值
• 示例响应：

{ "code": 182054, "msg": "默认值与字段类型不匹配", "data": null }

182055 FIELD_DEFAULT_VALUE_RULE_MISMATCH

• HTTP status：200
• 含义：默认值不满足字段的校验规则
• 典型触发条件：/v1/fieldDefinitions/save / update 设置的默认值不匹配字段的校验规则（正则）
• 处理建议：使默认值满足字段已配置的校验规则后重试
• 示例响应：

{ "code": 182055, "msg": "默认值不满足校验规则", "data": null }

182056 FIELD_DEFAULT_VALUE_NOT_IN_OPTIONS

• HTTP status：200
• 含义：默认值不在有效的内联选项中
• 典型触发条件：/v1/fieldDefinitions/save / update 选项型字段的默认值不属于其内联选项列表
• 处理建议：默认值须取自字段已定义的内联选项
• 示例响应：

{ "code": 182056, "msg": "默认值不在选项范围内", "data": null }

182057 FIELD_DEFAULT_VALUE_INVALID_TERM

• HTTP status：200
• 含义：默认值不是有效的术语
• 典型触发条件：/v1/fieldDefinitions/save / update 词表引用字段的默认值不是有效的术语标识
• 处理建议：默认值须为有效的术语标识
• 示例响应：

{ "code": 182057, "msg": "默认值不是有效术语", "data": null }

182058 FIELD_DEFAULT_VALUE_TERM_SET_MISMATCH

• HTTP status：200
• 含义：默认值对应的术语不属于指定词表
• 典型触发条件：/v1/fieldDefinitions/save / update 默认值术语与字段所引用的词表不一致
• 处理建议：默认值术语须属于字段引用的词表
• 示例响应：

{ "code": 182058, "msg": "默认值术语不属于该词表", "data": null }

182059 FIELD_DEFAULT_VALUE_TERM_DEPRECATED

• HTTP status：200
• 含义：默认值对应的术语已废弃
• 典型触发条件：/v1/fieldDefinitions/save / update 用已废弃术语作默认值
• 处理建议：改用未废弃的术语作默认值
• 示例响应：

{ "code": 182059, "msg": "默认值术语已废弃", "data": null }

182060 INLINE_OPTIONS_REQUIRED

• HTTP status：200
• 含义：内联选项类型必须提供选项列表
• 典型触发条件：/v1/fieldDefinitions/save / update 选项来源为内联选项，却未提供选项列表
• 处理建议：内联选项字段须提供非空的选项列表
• 示例响应：

{ "code": 182060, "msg": "请提供内联选项列表", "data": null }

182061 TERM_SET_ID_REQUIRED

• HTTP status：200
• 含义：词表引用类型必须提供词表 ID
• 典型触发条件：/v1/fieldDefinitions/save / update 选项来源为词表引用，却未提供词表 ID
• 处理建议：词表引用字段须指定要引用的词表 ID
• 示例响应：

{ "code": 182061, "msg": "请提供词表 ID", "data": null }

182062 TERM_SET_NOT_FOUND

• HTTP status：200
• 含义：词表不存在
• 典型触发条件：字段定义引用词表、或 /v1/termSets/update / delete、/v1/terms/* 按词表 ID 解析失败
• 处理建议：核对词表 ID；词表可能未创建或已删除
• 示例响应：

{ "code": 182062, "msg": "词表不存在", "data": null }

182063 TERM_SET_NO_INLINE_OPTIONS

• HTTP status：200
• 含义：词表引用类型不允许提供内联选项
• 典型触发条件：/v1/fieldDefinitions/save / update 选项来源为词表引用，却同时提供了内联选项
• 处理建议：选项来源在「词表引用」与「内联选项」之间二选一；词表引用字段不提供内联选项
• 示例响应：

{ "code": 182063, "msg": "词表引用字段不允许内联选项", "data": null }

182064 NO_OPTION_TYPE_NO_INLINE_OPTIONS

• HTTP status：200
• 含义：无选项类型不允许提供内联选项
• 典型触发条件：/v1/fieldDefinitions/save / update 非选项型字段提供了内联选项
• 处理建议：仅选项型字段可提供内联选项，无选项的字段类型不要提交选项列表
• 示例响应：

{ "code": 182064, "msg": "该字段类型不支持内联选项", "data": null }

182065 NO_OPTION_TYPE_NO_SOURCE_ID

• HTTP status：200
• 含义：无选项类型不允许提供选项来源 ID
• 典型触发条件：/v1/fieldDefinitions/save / update 非选项型字段提供了选项来源 ID（词表 ID）
• 处理建议：无选项的字段类型不要提交选项来源 ID
• 示例响应：

{ "code": 182065, "msg": "该字段类型不支持选项来源", "data": null }

182066 OPTION_VALUE_REQUIRED

• HTTP status：200
• 含义：选项值不能为空
• 典型触发条件：/v1/fieldDefinitions/save / update 提交的内联选项中存在缺少值的选项
• 处理建议：每个内联选项都须提供选项值
• 示例响应：

{ "code": 182066, "msg": "选项值不能为空", "data": null }

182067 OPTION_LABEL_REQUIRED

• HTTP status：200
• 含义：选项标签不能为空
• 典型触发条件：/v1/fieldDefinitions/save / update 提交的内联选项中存在缺少标签的选项
• 处理建议：每个内联选项都须提供显示标签
• 示例响应：

{ "code": 182067, "msg": "选项标签不能为空", "data": null }

182068 OPTION_VALUE_DUPLICATE

• HTTP status：200
• 含义：选项值重复
• 典型触发条件：/v1/fieldDefinitions/save / update 提交的内联选项中存在重复的选项值
• 处理建议：同一字段的内联选项值须唯一
• 示例响应：

{ "code": 182068, "msg": "选项值重复", "data": null }

182069 OPTION_DELETION_FORBIDDEN

• HTTP status：200
• 含义：不允许删除已有选项
• 典型触发条件：/v1/fieldDefinitions/update 时移除了字段已有的内联选项
• 处理建议：已有选项不支持删除，改为将其标记为废弃，以保证历史数据仍可解析
• 示例响应：

{ "code": 182069, "msg": "已有选项不可删除，请标记为废弃", "data": null }

182070 OPTION_SERIALIZE_FAILED

• HTTP status：200
• 含义：选项数据处理失败
• 典型触发条件：/v1/fieldDefinitions/save / update 提交选项数据时处理失败
• 处理建议：选项数据处理失败，请稍后重试；持续失败请联系管理方
• 示例响应：

{ "code": 182070, "msg": "选项数据处理失败，请重试", "data": null }

182071 TERM_CODE_EXISTS

• HTTP status：200
• 含义：术语编码在该词表中已存在
• 典型触发条件：/v1/terms/save / batchSave 新增术语时，编码与同词表内已有术语重复
• 处理建议：同一词表内术语编码须唯一，换用未占用的编码
• 示例响应：

{ "code": 182071, "msg": "术语编码已存在", "data": null }

182072 TERM_REFERENCED_BY_METADATA

• HTTP status：200
• 含义：术语已被元数据引用，无法删除
• 典型触发条件：/v1/terms/delete 删除已被资源元数据引用的术语
• 处理建议：被引用的术语不支持删除，改为将其标记为废弃
• 示例响应：

{ "code": 182072, "msg": "术语已被引用，无法删除", "data": null }

182073 TERM_HAS_CHILDREN

• HTTP status：200
• 含义：术语下存在子术语，无法删除
• 典型触发条件：/v1/terms/delete 删除仍有子术语的术语
• 处理建议：先删除或迁移其下的子术语，再删除该术语
• 示例响应：

{ "code": 182073, "msg": "术语下存在子术语", "data": null }

182074 TERM_SET_NOT_HIERARCHICAL

• HTTP status：200
• 含义：词表不支持层级结构，不允许设置父术语
• 典型触发条件：/v1/terms/save / update 给非层级词表的术语设置父术语
• 处理建议：仅层级词表的术语可设置父术语；非层级词表不要提交父术语
• 示例响应：

{ "code": 182074, "msg": "该词表不支持层级结构", "data": null }

182075 TERM_NOT_FOUND

• HTTP status：200
• 含义：术语不存在
• 典型触发条件：/v1/terms/update / delete、术语排序、或字段默认值校验等按术语标识解析失败
• 处理建议：核对术语标识；术语可能未创建或已删除
• 示例响应：

{ "code": 182075, "msg": "术语不存在", "data": null }

182076 TERM_NOT_IN_TERM_SET

• HTTP status：200
• 含义：术语不属于当前词表
• 典型触发条件：/v1/terms/update、/v1/termSets/sortTerms 等操作的术语与目标词表不一致
• 处理建议：确保操作的术语属于目标词表
• 示例响应：

{ "code": 182076, "msg": "术语不属于当前词表", "data": null }

182077 TERM_SORT_CROSS_PARENT

• HTTP status：200
• 含义：排序项跨越多个父术语，无法在同一批内排序
• 典型触发条件：/v1/termSets/sortTerms 一批排序项归属于不同父术语
• 处理建议：排序须限定在同一父术语的子术语范围内，按父术语分组分批排序
• 示例响应：

{ "code": 182077, "msg": "排序项跨越多个父术语", "data": null }

182078 TERM_PARENT_NOT_FOUND

• HTTP status：200
• 含义：父术语不存在
• 典型触发条件：/v1/terms/save / update 指定的父术语不存在
• 处理建议：核对父术语标识
• 示例响应：

{ "code": 182078, "msg": "父术语不存在", "data": null }

182079 TERM_PARENT_NOT_IN_TERM_SET

• HTTP status：200
• 含义：父术语不属于当前词表
• 典型触发条件：/v1/terms/save / update 指定的父术语属于其它词表
• 处理建议：父术语须与子术语处于同一词表内
• 示例响应：

{ "code": 182079, "msg": "父术语不属于当前词表", "data": null }

182080 TERM_SET_CODE_EXISTS

• HTTP status：200
• 含义：词表编码已存在
• 典型触发条件：/v1/termSets/save 新建词表时，编码与已有词表重复
• 处理建议：词表编码须唯一，换用未占用的编码
• 示例响应：

{ "code": 182080, "msg": "词表编码已存在", "data": null }

182081 TERM_SET_REFERENCED_BY_FIELD

• HTTP status：200
• 含义：词表已被字段定义引用，无法删除
• 典型触发条件：/v1/termSets/delete 删除仍被字段定义引用的词表
• 处理建议：先解除引用该词表的字段定义绑定，再删除词表
• 示例响应：

{ "code": 182081, "msg": "词表已被字段引用，无法删除", "data": null }

182082 TERM_SET_HAS_REFERENCED_TERMS

• HTTP status：200
• 含义：词表下存在已被元数据引用的术语，无法删除
• 典型触发条件：/v1/termSets/delete 删除含有被元数据引用术语的词表
• 处理建议：词表内仍有被引用的术语时不支持删除；可先处理相关引用
• 示例响应：

{ "code": 182082, "msg": "词表下存在被引用的术语", "data": null }

182083 JSON_FIELD_CARDINALITY_FORBIDDEN

• HTTP status：200
• 含义：JSON 类型字段固定为单值，不允许设置多值基数
• 典型触发条件：/v1/fieldDefinitions/save / update 把 JSON 类型字段配置为多值
• 处理建议：JSON 类型字段固定为单值，不要设置多值基数
• 示例响应：

{ "code": 182083, "msg": "JSON 字段仅支持单值", "data": null }

182084 JSON_FIELD_OPTION_SOURCE_FORBIDDEN

• HTTP status：200
• 含义：JSON 类型字段不支持选项来源
• 典型触发条件：/v1/fieldDefinitions/save / update 给 JSON 类型字段配置选项来源（内联选项 / 词表引用）
• 处理建议：JSON 类型字段不配置任何选项来源
• 示例响应：

{ "code": 182084, "msg": "JSON 字段不支持选项来源", "data": null }

182085 JSON_FIELD_VALIDATION_RULE_FORBIDDEN

• HTTP status：200
• 含义：JSON 类型字段不支持校验规则
• 典型触发条件：/v1/fieldDefinitions/save / update 给 JSON 类型字段配置正则校验规则
• 处理建议：JSON 类型字段不配置正则校验规则
• 示例响应：

{ "code": 182085, "msg": "JSON 字段不支持校验规则", "data": null }

182086 JSON_FIELD_SEARCHABLE_FORBIDDEN

• HTTP status：200
• 含义：JSON 类型字段不支持检索
• 典型触发条件：/v1/fieldDefinitions/save / update 给 JSON 类型字段开启检索
• 处理建议：JSON 类型字段固定不参与检索，不要开启检索
• 示例响应：

{ "code": 182086, "msg": "JSON 字段不支持检索", "data": null }

182087 JSON_FIELD_FILTERABLE_FORBIDDEN

• HTTP status：200
• 含义：JSON 类型字段不支持过滤
• 典型触发条件：/v1/fieldDefinitions/save / update 给 JSON 类型字段开启过滤
• 处理建议：JSON 类型字段固定不参与元数据过滤，不要开启过滤
• 示例响应：

{ "code": 182087, "msg": "JSON 字段不支持过滤", "data": null }

182088 FIELD_BOUND_BY_RESOURCE

• HTTP status：200
• 含义：字段已被某个文档 / 容器实例直接绑定，无法删除
• 典型触发条件：/v1/fieldDefinitions/delete 删除一个仍被资源级字段直绑引用的字段
• 处理建议：先用字段使用点盘点（/v1/resourceFieldBindings/getUsagePage）查出直绑该字段的文档与容器，逐个解绑（/v1/resourceFieldBindings/unbind）后再删除字段
• 示例响应：

{ "code": 182088, "msg": "该字段已被资源直接绑定，无法删除", "data": null }

182090 RESOURCE_FIELD_NOT_ACTIVE_FOR_BINDING

• HTTP status：200
• 含义：字段不是启用状态，无法直绑到资源
• 典型触发条件：/v1/resourceFieldBindings/bind 绑定一个已停用 / 草稿状态的字段
• 处理建议：先将字段置为启用状态再直绑
• 示例响应：

{ "code": 182090, "msg": "字段未启用，无法绑定到资源", "data": null }

182091 RESOURCE_FIELD_TARGET_MISMATCH

• HTTP status：200
• 含义：字段的适用目标与资源类别不匹配
• 典型触发条件：/v1/resourceFieldBindings/bind 把仅适用容器的字段绑到文档，或把仅适用文档的字段绑到容器（文档资源要求字段适用 DOCUMENT，容器资源要求适用 CONTAINER）
• 处理建议：确认字段的适用目标与目标资源类别一致后再直绑
• 示例响应：

{ "code": 182091, "msg": "字段适用目标与资源类别不匹配", "data": null }

182092 RESOURCE_FIELD_ALREADY_BOUND

• HTTP status：200
• 含义：该字段已直绑到此资源
• 典型触发条件：/v1/resourceFieldBindings/bind 对同一资源重复直绑同一字段（含并发重复提交）
• 处理建议：作为幂等提示处理即可；需要调整必填 / 默认值 / 排序改用更新覆盖配置端点（/v1/resourceFieldBindings/update），无须先解绑
• 示例响应：

{ "code": 182092, "msg": "该字段已绑定到此资源", "data": null }

182093 RESOURCE_FIELD_BINDING_FAILED

• HTTP status：200
• 含义：字段直绑失败（并发竞态）
• 典型触发条件：/v1/resourceFieldBindings/bind 高并发下同一资源-字段绑定发生写竞争
• 处理建议：稍后重试即可；若持续失败，携带 rid 联系支持团队
• 示例响应：

{ "code": 182093, "msg": "字段绑定失败，请稍后重试", "data": null }

182094 RESOURCE_FIELD_BINDING_NOT_FOUND

• HTTP status：200
• 含义：资源-字段直绑关系不存在
• 典型触发条件：/v1/resourceFieldBindings/unbind / update 操作一个已被解绑或从未建立的直绑关系
• 处理建议：先用按资源查询（/v1/resourceFieldBindings/getByResource）确认该资源上的直绑现状，再操作
• 示例响应：

{ "code": 182094, "msg": "资源-字段绑定关系不存在", "data": null }

182095 RESOURCE_FIELD_TEMPLATE_CONFLICT

• HTTP status：200
• 含义：直绑失败——该字段已由绑定到本资源的资源级模板提供（同层冲突）
• 典型触发条件：/v1/resourceFieldBindings/bind 直绑一个已由本资源某资源级模板携带的字段
• 处理建议：该字段已在本资源生效，无需再直绑；若要单独调整它在本资源上的配置，请改从模板层调整或解除相应模板绑定
• 示例响应：

{ "code": 182095, "msg": "该字段已由绑定到本资源的模板提供", "data": null }

182096 RESOURCE_FIELD_BINDING_UPDATE_FAILED

• HTTP status：200
• 含义：更新资源-字段直绑覆盖配置失败（绑定已被解绑或删除）
• 典型触发条件：/v1/resourceFieldBindings/update 更新覆盖配置时，目标直绑关系已被并发解绑 / 删除
• 处理建议：重新查询该资源的直绑现状；如需该字段请重新直绑（/v1/resourceFieldBindings/bind）
• 示例响应：

{ "code": 182096, "msg": "更新直绑覆盖配置失败：绑定已不存在", "data": null }