EmberJS 3.28访问关联属性触发setRecordDataFor非法标识符断言报错

触发原因 #

这个断言是Ember Data 3.28引入的标识符系统校验逻辑触发的，常见触发场景如下：

• 后端返回的关联数据id类型不匹配：Ember Data要求所有记录id为字符串类型，若后端返回数字类型的id，隐式转换时会触发校验失败
• 关联类型名称不匹配：后端返回的monitors关联的type字段和模型定义的domain-monitor（短横线命名）不一致，比如出现domain_monitor、DomainMonitor等拼写错误
• 自定义适配器/序列化器修改了关联数据的内部结构，或者手动修改了记录的私有_relationships属性，破坏了标识符的一致性
• 第三方Ember Data插件版本和3.28不兼容，修改了RecordData的内部处理逻辑

排查步骤 #

1. 检查findRecord('project')接口返回的原始JSON结构，重点核对两个点：
   • 所有domain-monitor类型的记录（包括side load的关联数据）id是否为字符串类型
   • monitors关联的type字段值是否完全为domain-monitor，无大小写、命名格式错误
2. 若存在id类型问题，可在应用序列化器中新增统一id转换逻辑，示例代码如下：

// app/serializers/application.js
import JSONAPISerializer from '@ember-data/serializer/json-api';

export default class ApplicationSerializer extends JSONAPISerializer {
  normalizeResponse(store, primaryModelClass, payload, id, requestType) {
    const normalized = super.normalizeResponse(...arguments);

    const processRecord = (record) => {
      if (record.id) record.id = String(record.id);
      if (record.relationships) {
        Object.values(record.relationships).forEach(rel => {
          if (!rel.data) return;
          Array.isArray(rel.data) ? rel.data.forEach(processRecord) : processRecord(rel.data);
        });
      }
    };

    if (normalized.data) {
      Array.isArray(normalized.data) ? normalized.data.forEach(processRecord) : processRecord(normalized.data);
    }
    if (normalized.included) {
      normalized.included.forEach(processRecord);
    }

    return normalized;
  }
}

3. 临时验证方案：调用findRecord时新增include参数预加载关联，跳过懒加载逻辑验证问题是否消失：

return this.store.findRecord('project', project_id, { include: 'monitors' });

4. 禁用所有和Ember Data相关的第三方插件逐一排查，确认是否存在兼容性问题。

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