Autodesk ACC接口返回文件夹displayName未更新及字段选型咨询

对应问题的结论如下： #

1. 部分客户侧接口返回旧displayName的原因
   这个差异来自ACC不同租户环境的缓存策略不一致。自有测试账号复现失败，是因为免费测试租户的元数据缓存过期时间设置极短，重命名操作后几乎实时刷新；而付费企业租户的文件夹内容接口默认走多层缓存（CDN、区域节点缓存、租户元数据缓存），重命名操作触发的缓存失效存在最长24小时的延迟窗口。如果客户是通过Desktop Connector本地端、第三方集成接口触发的文件夹重命名，操作元数据的同步优先级低于网页端直接操作，延迟会更明显，就会出现网页端已经显示新名称、接口仍返回旧displayName的情况，不属于接口逻辑错误。

2. displayName是否为最优展示字段，是否需要替换为name
   不建议替换为name字段，displayName本身就是ACC官方设计用于前端展示的字段：

   • displayName会自动处理多语言适配、特殊字符转义、系统文件夹的本地化展示，完全匹配网页端的展示逻辑；
   • name是底层存储的原始标识字段，没有做展示层适配，直接使用会出现多语言下内置文件夹名称显示错误、特殊字符乱码的问题。
     遇到的不同步是缓存机制导致的偶发问题，不是字段选型错误。

3. name字段是否始终和ACC端展示名称一致
   答案是否定的，name字段存在三类固定的不一致场景：

   • 内置系统文件夹（如项目文件、回收站、共享文件夹）的name字段存储固定英文标识，ACC网页端会根据用户当前语言环境展示对应本地化名称，和name返回值无关；
   • 文件夹名称包含前端需要转义的特殊字符时，name返回原始字符，网页端展示转义后的值；
   • 重命名操作触发时，name字段的更新同样受缓存策略限制，同步速度不会比displayName更快，替换字段完全解决不了旧值残留的问题。

实操修复建议 #

不需要调整字段选型，只需要在调用GET projects/:project_id/folders/:folder_id/contents接口时追加请求参数noCache=true，即可强制绕过缓存拉取最新的元数据，这个参数是接口原生支持的，不会触发额外限流。如果需要覆盖极端延迟场景，可以在用户进入文件夹时，单独调用单文件夹详情接口GET projects/:project_id/folders/:folder_id拉取当前文件夹的元数据，这个单对象查询接口的缓存优先级更高，同步延迟通常在1分钟以内。

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