如何在 Unity 中正确解析嵌套 JSON 数据（PHP 后端返回结构）-php教程-PHP中文网

如何在 Unity 中正确解析嵌套 JSON 数据（PHP 后端返回结构）

本文详解 Unity 使用 JsonUtility 解析 PHP 返回的嵌套 JSON 时的常见类型不匹配问题，重点解决因 JSON 结构与 C# 类定义不一致导致字段为空的问题，并提供可直接复用的序列化类模板与完整解析流程。

本文详解 unity 使用 `jsonutility` 解析 php 返回的嵌套 json 时的常见类型不匹配问题，重点解决因 json 结构与 c# 类定义不一致导致字段为空的问题，并提供可直接复用的序列化类模板与完整解析流程。

Unity 的 JsonUtility.FromJson() 是一个轻量、高效但严格受限的 JSON 反序列化工具——它仅支持符合特定规则的 C# 类型（如 [Serializable] 类、基础类型、一维数组），且要求 JSON 键名与 C# 字段名完全一致、嵌套层级必须精确映射。你遇到的 Wallet_data[0].Wallet_Number 始终为空，根本原因在于：PHP 返回的 JSON 是顶层包含 Wallet_Number 数组和 content 字段的对象，而你的 OVHJsonObject 类试图将整个 JSON 直接反序列化为单个对象，导致结构错位，所有字段均无法绑定。

✅ 正确的 C# 类结构设计

需严格对应 PHP 输出的 JSON 结构：

{
  "Wallet_Number": [
    { "Wallet_Number": "...", "NFT": "...", "Montant_Mise": "...", "Date_Spin": "..." },
    ...
  ],
  "content": 6
}

因此，应定义两个嵌套的 [Serializable] 类：

[System.Serializable]
public class WalletEntry
{
    public string Wallet_Number;
    public string NFT;
    public string Montant_Mise;
    public string Date_Spin;
}

[System.Serializable]
public class WalletResponse
{
    public WalletEntry[] Wallet_Number; // 注意：字段名必须与 JSON key 完全相同（含大小写）
    public int content;
}

⚠️ 关键注意：

Wallet_Number 在 JSON 中既是顶层字段名，又是数组内对象的字段名，这是合法的，但 C# 中需用不同类名区分语义（如 WalletEntry）避免歧义；

WalletResponse.Wallet_Number 是 WalletEntry[] 类型，而非 string —— 这是修复空值的核心；

所有字段必须为 public，且不可使用 readonly 或属性（get/set），否则 JsonUtility 将忽略。

✅ 正确的解析逻辑（替换原 GetRequest 中的解析部分）

case UnityWebRequest.Result.Success:
    Debug.Log("Received: " + webRequest.downloadHandler.text);

    // 使用正确的类型反序列化整个响应
    WalletResponse response = JsonUtility.FromJson<walletresponse>(webRequest.downloadHandler.text);

    // 安全访问：先检查数组是否非空
    if (response.Wallet_Number != null && response.Wallet_Number.Length > 0)
    {
        Debug.Log("First Wallet Number: " + response.Wallet_Number[0].Wallet_Number);
        Debug.Log("Total Records: " + response.content);

        // 可选：复制到你的全局数组（注意长度匹配）
        System.Array.Copy(response.Wallet_Number, Wallet_data, 
            Mathf.Min(response.Wallet_Number.Length, Wallet_data.Length));
    }
    else
    {
        Debug.LogWarning("No wallet data received.");
    }
    break;</walletresponse>

✅ 补充建议与最佳实践

避免硬编码数组长度：原代码中 new OVHJsonObject[9] 容易越界或浪费内存。推荐改用 List 动态存储：

输入关键词，自动扫描全网用户痛点，生成PRD并输出OpenClaw标准任务JSON。
搜索网络用户痛点并输出PRD文档JSON

下载
```
public List<walletentry> walletList = new List<walletentry>();
// 解析后：walletList = new List<walletentry>(response.Wallet_Number);</walletentry></walletentry></walletentry>
```
日期与数字格式处理：Montant_Mise 在 JSON 中为字符串（如 "0,01"），若需计算，请在 C# 中用 float.Parse(value.Replace(",", ".")) 转换（注意文化差异）；Date_Spin 建议 PHP 端统一输出 ISO 格式（如 "2022-04-06"），便于 DateTime.TryParse() 解析。
错误防御：JsonUtility.FromJson 在 JSON 格式错误时静默失败（返回默认值），务必配合 string.IsNullOrEmpty() 和空数组检查。
替代方案（进阶）：如需更灵活解析（如动态 key、复杂嵌套、null 安全），推荐使用 Newtonsoft.Json（需导入 Unity Package Manager 的 com.unity.nuget.newtonsoft-json），支持 JObject.Parse() 和强类型泛型 JsonConvert.DeserializeObject()。