react-admin v3.15中ReferenceInput无法填充SelectInput的排查建议

资源定义与权限检查 #

• 确认异常下拉框对应的资源名称在<Admin>组件中已注册，拼写必须完全一致（大小写、下划线/短横线的差异都会导致请求失败）
• 检查当前用户是否拥有该资源的list权限，react-admin会自动拦截无权限请求，可能没有报错但返回空数据

DataProvider 隐式处理差异 #

• 即便你没对正常端点做特殊处理，也要检查dataProvider.getList里有没有针对资源名称的分支逻辑（比如某些资源被过滤、字段映射规则不一样）
• 确认响应数据的主键字段是否符合默认约定：react-admin默认主键是id，如果异常资源的主键是uuid这类其他字段，要么在资源定义时指定id属性，要么在DataProvider里统一处理
• 检查响应体中数据数组的字段名：默认要求数组放在data字段下，如果异常API用的是items这类其他字段，组件会无法识别数据

下拉框组件属性排查 #

• 对比两个下拉框的<ReferenceInput>/<SelectInput>配置：
  • 确认source属性对应表单字段的正确性
  • 检查reference属性是否精准指向目标资源名称
  • 验证optionText和optionValue是否匹配资源的实际字段（比如异常资源的显示字段是title不是name）
• 排查是否给异常下拉框加了不必要的filter或sort参数，导致API返回空结果（比如误加了{ status: 'active' }但该资源没有符合条件的数据）

API响应的隐式差异 #

• 表面请求头、响应体一致，但要深挖细节：
  • 响应数据的字段类型：比如正常资源的id是数字，异常资源的id是字符串，部分场景下会导致组件无法匹配
  • 响应体的嵌套结构：比如异常资源的data数组里的对象有嵌套字段，而组件期望直接取顶层字段
  • 响应的Content-Type是否严格为application/json，如果返回text/plain会导致DataProvider解析失败

实用调试技巧 #

• 在浏览器DevTools的Network面板对比两个请求：
  • 确认请求URL、参数完全符合预期
  • 查看响应数据的原始内容，排查有没有隐藏的格式问题（比如多余空格、特殊字符）
• 在DataProvider的getList方法里加日志，打印请求参数和解析后的数据，看是不是在转换环节丢了内容
• 把异常下拉框的reference换成正常资源的名称，看能不能正常渲染，以此区分是资源还是组件的问题

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