本文详解 unity 使用 `unitywebrequest.post()` 发送 `dictionary
在 Unity 中，向 PHP 服务器提交表单数据（如配置项、元信息或文件上传前的描述字段）时，UnityWebRequest.Post(string url, Dictionary
以下是你客户端代码的优化示例（含关键修复与健壮性增强）：
基于 AIOZ Stream API 的免费音频上传技能，通过三步流程（Create → Upload Part → Complete）将本地音频文件上传至 AIOZ 流媒体平台。支持默认快速上传方式，使用默认编码配置，上传完成后返回 HLS 流媒体播放链接。使用 API Key (stream-publ...)进行认证。
Dictionary<string, string> formData = new Dictionary<string, string>();
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
- ✅ 使用 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');
最后，一个最小可行的服务端接收模板供参考：
<?php
header('Content-Type: application/json; charset=utf-8');
// 白名单定义（与客户端约定的键名完全一致）
$expectedKeys = ['App', 'Version', 'BuildNumber', 'UserID'];
$data = [];
foreach ($expectedKeys as $key) {
if (!isset($_POST[$key])) {
http_response_code(400);
echo json_encode(['error' => "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 问题。
