UE5.3打包构建下FJsonObjectConverter序列化变量名驼峰异常

问题现象 #

• 基于UE5.3开发，定义UPROPERTY变量issuetype
• 调用FJsonObjectConverter::UStructToJsonObject序列化时，打包构建后变量名被自动转为issueType，但PIE（Play In Editor）运行时无此异常
• 同类复合词变量如customfield未出现该大小写转换问题

相关代码示例 #

USTRUCT定义 #

USTRUCT()
struct FMyIssue
{
    GENERATED_BODY()

public:
    FMyIssue() = default;

    UPROPERTY()
    TMap<FString, FString> issuetype = {{TEXT("name"), TEXT(" ") }};
};

序列化实现代码 #

TSharedPtr<FMyStruct> myStruct = MakeShared<FMyStruct>();
TSharedPtr<FJsonObject> jsonObject = FJsonObjectConverter::UStructToJsonObject(*myStruct);

FString serializedSelf;
const TSharedRef<TJsonWriter<>> jsonWriter = TJsonWriterFactory<>::Create(&serializedSelf);
FJsonSerializer::Serialize(jsonObject.ToSharedRef(), jsonWriter);

const FString fileLocation = TEXT("path/to/file");
FFileHelper::SaveStringToFile(serializedSelf, *fileLocation);

打包构建后的输出结果 #

{
    "issueType":
        {
            "name": " "
        }
}

排查方向与解决方案建议 #

1. UHT编译模式差异检查
   打包构建时UHT（Unreal Header Tool）可能启用了与PIE模式不同的代码生成规则，针对包含type这类特定后缀的词汇，可能存在隐藏的驼峰转换逻辑，即使FJsonObjectConverter::StandardizeCase表面只处理首字符和ID中的d。

2. 显式指定序列化字段名
   放弃依赖自动转换逻辑，直接在UPROPERTY中通过元标签指定固定字段名，彻底避免大小写转换问题：

   UPROPERTY(meta=(JsonFieldName="issuetype"))
   TMap<FString, FString> issuetype = {{TEXT("name"), TEXT(" ") }};
   

3. 自定义序列化逻辑
   绕过FJsonObjectConverter的自动处理，手动构建JSON对象以完全控制字段名：

   TSharedPtr<FJsonObject> CustomSerialize(const FMyIssue& Struct)
   {
       TSharedPtr<FJsonObject> JsonObj = MakeShared<FJsonObject>();
       JsonObj->SetObjectField(TEXT("issuetype"), FJsonObjectConverter::MapToJsonObject(Struct.issuetype));
       return JsonObj;
   }
   

4. 项目序列化配置核查
   检查项目设置中是否存在全局JSON序列化的大小写规则配置，部分配置可能仅在打包构建模式下生效，导致与PIE模式的行为差异。

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