如何在 Unity 中通过 POST 发送字符串字典并正确接收处理

本文详解 unity 使用 `unitywebrequest.post()` 发送 `dictionary` 到 php 服务器的完整流程，包括客户端发送逻辑、服务端接收方式（基于 `$_post`）、常见错误排查（如 http 500）及健壮性处理建议。

在 Unity 中，向 PHP 服务器提交表单数据（如配置项、元信息或文件上传前的描述字段）时，UnityWebRequest.Post(string url, Dictionary formData) 是最直接、兼容性最佳的方式。该方法会自动将字典序列化为标准 application/x-www-form-urlencoded 格式（即 key1=value1&key2=value2），无需手动 JSON 编码或设置 Header —— 这正是与 UnityWebRequest.Put() 或自定义 JSON 请求的关键区别。

以下是你客户端代码的优化示例（含关键修复与健壮性增强）：

Dictionary formData = new Dictionary();
using (StreamReader sr = file.OpenText())
{
    string line;
    while ((line = sr.ReadLine()) != null)
    {
        string[] data = line.Split(';');
        if (data.Length < 2) continue; // 防止索引越界

        string key = data[0].Trim();
        string value = data.Length > 1 ? data[1].Trim() : "";

        // 空值统一处理为占位符（避免 PHP isset() 失效）
        if (string.IsNullOrEmpty(value)) value = " ";

        formData[key] = value;
    }
}

// ✅ 正确：使用 Post 的 Dictionary 重载（自动编码 + Content-Type 设置）
UnityWebRequest request = UnityWebRequest.Post(serverBaseURL, formData);
request.timeout = 30;

yield return request.SendWebRequest();

if (request.result == UnityWebRequest.Result.Success)
{
    Debug.Log("上传元数据成功: " + request.downloadHandler.text);
}
else
{
    Debug.LogError($"请求失败 [{request.responseCode}]: {request.error}");
    // 建议检查 responseCode == 500 → 往往是服务端 PHP 异常（如未定义变量、函数名错误）
}

服务端 PHP 接收要点：
Unity 发送的 Dictionary 会以标准表单形式落入 $_POST 超全局数组中。例如，若字典包含 {"App": "MyGame", "Version": "1.2.0"}，PHP 可直接通过 $_POST['App'] 和 $_POST['Version'] 访问。务必注意：

• ✅ 使用 isset($_POST['key']) 判断字段是否存在（而非 empty()，因 " " 或 "0" 会被误判为 false）；
• ⚠️ 键名必须严格匹配（大小写敏感、无空格/特殊字符）；服务端报错 HTTP 500 的常见原因是：客户端传了 AppID，但服务端却读取 $_POST['appid'] 或 $_POST['AppId']；
• ? 建议对关键字段做白名单校验（如你的 $expectedFormInputCommon 数组），拒绝未声明字段，提升安全性；
• ? 若需支持中文或特殊字符，请确保 PHP 文件保存为 UTF-8 无 BOM，并在响应头中显式声明：

  header('Content-Type: text/plain; charset=utf-8');

最后，一个最小可行的服务端接收模板供参考：

NexChatGPT

火爆全网的IDEA插件，支持IDEA全家桶

下载

 "Missing required field: $key"]);
        exit;
    }
    $data[$key] = trim($_POST[$key]);
}

// 此处可进一步处理（如存入数据库、生成 JSON 文件等）
echo json_encode(['status' => 'success', 'received' => $data]);
?>

总结：Unity 的 UnityWebRequest.Post(url, dict) 是发送键值对数据的推荐方案；服务端应基于 $_POST 直接读取，重点保障键名一致性、空值鲁棒性及字段白名单校验——这能规避绝大多数 500 Internal Server Error 和 400 Bad Request 问题。