未使用记录类型，但新增全局选择列表值无法选取的问题

问题场景 #

• 已为全局选择列表值集添加新值
• 自定义对象编辑页面无法选取该新值
• API更新字段时触发INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST错误
• 已尝试刷新页面、更换浏览器，且排除了以下常见原因：
  • 未使用记录类型，无需更新记录类型配置
  • 目标字段无字段依赖关系
  • 清除缓存/更换浏览器无效

排查与解决建议 #

1. 确认字段与全局值集的绑定关系
   进入自定义对象的目标字段编辑页面，检查“值集”选项是否指向你修改的那个全局值集。避免因同名值集或误操作导致字段绑定到未更新的其他值集。

2. 检查全局值集新值的激活状态
   打开全局值集的编辑界面，确认新增值的“激活”复选框已勾选。未激活的选项不会在前端页面和API请求中显示或生效。

3. 验证字段的受限选择列表配置
   若目标字段开启了“受限选择列表”，即使绑定全局值集，也可能存在额外的选项限制。进入字段编辑页面，点击值集区域的“编辑”按钮，确认新增值在“可用值”列表中。

4. 核对API请求的参数准确性
   API更新时，传入的新值必须和全局值集里的选项完全匹配，包括大小写、空格、特殊字符。可以调用describeSObject接口获取该字段的官方可用值列表，对比传入值是否一致。

5. 强制触发后台缓存同步
   Salesforce后台可能存在缓存延迟，尝试重新保存一次全局值集，或临时将字段关联到其他值集再改回原全局值集，强制触发后台配置同步。

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