Bug 记录:UE 结构体转 JSON 时 Key 字段大小写异常 (Editor 与打包后表现不一致)

问题描述 :

在使用 FJsonObjectConverter::UStructToJsonObjectString 将带有 UPROPERTY 的结构体(USTRUCT)转换为 JSON 字符串时,生成的 JSON Key 在 UE 编辑器(PIE)下和打包发布(Packaged)后出现大小写不一致的现象。

示例:

结构体中定义了 UPROPERTY() FString id;

  • 编辑器运行结果: {"id": "..."} (正常小写)

  • 打包发布后结果: {"iD": "..."} (出现异常大写 'D')

根本原因 :

此问题由 Unreal Engine 底层的 FName 机制以及运行时加载顺序差异导致,并非 JSON 转换器本身的 Bug。

  1. FName 的大小写不敏感与全局表:

    UE 的反射系统(UHT)使用 FName 来存储结构体中的变量名(Property Name)。FName 为了提高检索效率,是大小写不敏感的,并共用一个全局字符串表(Name Pool)。

    当引擎生命周期中第一次 创建某个特定拼写的 FName 时(例如 "iD"),该字符串连同其当前的大小写格式就会被永久缓存在全局表中。后续所有同名(忽略大小写)的 FName 都会直接复用第一次注册时的大小写格式。

  2. 环境加载顺序差异:

    编辑器模式和打包后的独立运行环境下,引擎模块(Modules)和资源(Assets)的加载顺序完全不同。

    打包后,在我们的结构体加载前,引擎内部的其他模块或第三方插件率先向内存中注册了名为 "iD" 的 FName。

  3. 转换器取值逻辑:

    FJsonObjectConverter 在执行序列化时,会调用 Property->GetName() 获取变量名作为 JSON 的 Key。因为全局表已被污染为 "iD",导致导出的 JSON Key 发生改变。诸如 id、name、type 等通用极简词汇极易触发此命名冲突。

解决方案:

方案一:放弃反射自动转换,手动组装 JSON(最推荐,安全稳定)

针对对接外部服务器(后端通常对大小写严格敏感)的接口,避免使用 FJsonObjectConverter,改用底层的 FJsonObject 手动序列化,100% 掌控 Key 名:

C++

复制代码
TSharedPtr<FJsonObject> JsonObj = MakeShareable(new FJsonObject);
JsonObj->SetStringField(TEXT("id"), ResData.id); // 强行硬编码小写 "id"

FString JsonString;
TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&JsonString);
FJsonSerializer::Serialize(JsonObj.ToSharedRef(), Writer);

方案二:修改变量命名规避冲突

如果前后端接口允许,在定义 UPROPERTY 时避免使用 id 这样过于泛用的词汇,增加特定前缀降低碰撞概率,例如:

C++

复制代码
UPROPERTY()
FString ResId; // 替代 id
总结 :
  • UE 的 FName 机制决定了依赖反射获取的名称无法保证绝对的大小写安全。

  • 凡是涉及到跨系统通信(网络协议、保存本地 JSON/XML 配置文件等)且要求严格大小写的场景,永远不要轻信自动反射序列化工具对于通用词汇(id, name, data 等)的处理,手动构建或加特异性前缀才是最稳妥的做法。

相关推荐
wflynn5 小时前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术
zdr尽职尽责7 小时前
终端工具凭空消失:Codex + GPT-6 的一次完整排障复盘
数据库·gpt·学习·ai
佛系1899 小时前
从服务端日志精确分离搜索抓取、监控探测与真实流量的实操清单
ai·大模型·seo·geo·结构化数据·indexnow
aiotto资源分享10 小时前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
一起学安全技术14 小时前
拆大模型 11|大模型面试拷问:12 问逐层拆
人工智能·ai·语言模型·面试·职场和发展·求职招聘
TomEval1 天前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
一起学安全技术1 天前
拆大模型 10|结构化输出:让模型返回数据,而不是一段话
人工智能·语言模型·json
AI算力1 天前
企业调研——工业边缘计算隐形黑马,腾视科技以“硬件+算法”加速出海落地!
人工智能·ai·边缘计算·ai算力·无人叉车·物理ai·ainas
真上帝的左手1 天前
26. AI-大语言模型-基础
人工智能·ai·架构·llm·大语言模型
用户298698530142 天前
在 Python 中把 Word 文档转换为 JSON 的三种实现方式
python·json·api