UTS自定义类型涉及联合类型时会解析成UTSJSONObject这个是BUG吗？

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据你的描述和知识库中的相关信息，这不是BUG，而是 UTS 在 uni-app 环境下的已知设计限制。

原因分析

你在代码中使用了 uni.request<ApiResult<Test>>，并且 ApiResult 的 data 字段是联合类型 T | T[] | null。

在 UTS 中，由于底层跨语言通信和类型系统的约束，对于复杂类型和联合类型的处理存在限制。当 uni-app (JS环境) 将数据传递给 UTS 或 UTS 处理来自网络请求的复杂数据时，对于未明确为单一具体类型（例如普通的 type 结构）的数据，默认会将其解析为 UTSJSONObject。你的 data 字段刚好是联合类型，UTS 在运行时无法根据类型定义自动将其解析为你自定义的 Test 类型，因此表现为 UTSJSONObject。

知识库文档 uts与uni-app环境数据交互说明-2 中明确提到：

有些场景，我们需要参数对象包含对象数组... 目前在uni-app 环境下，复杂参数的传递是存在一定的缺陷。我们不能将teacher 声明为具体的类型数组，需要声明为any数组... 这个问题，我们稍后会改进。

解决方案

目前有以下几种方式可以绕过这个限制，正常访问你的数据：

方案1：做类型断言（推荐）

直接使用 as 将 data 字段强制转换为你期望的类型。

uni.request<ApiResult<any>>({  
  url: 'xxx',  
  method: 'GET',  
  success: (res) => {  
    // 将 data 断言为你需要的数据类型  
    const result = res.data as ApiResult<Test>;  
    const item = result.data as Test; // 如果是单个对象  
    console.log(item.id, item.name);  

    // 如果是数组，可以这样处理  
    // const items = result.data as Test[];  
  }  
});

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

这也从 ask社区 得到了验证，通过 as 断言是处理 uni.request 返回泛型的通用做法。

方案2：通过 JSON 序列化/反序列化转换

通过将 UTSJSONObject 序列化为字符串再解析，可以强制转换为普通 JS 对象并保留类型。

success: (res) => {  
    const result : ApiResult<Test> = JSON.parse(JSON.stringify(res.data));  
    console.log(result.data); // data 此时不再是 UTSJSONObject  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
注意：如果你的对象中包含函数等无法序列化的内容，此方法会将这些字段转为 null。

方案3：调整类型定义（简单场景）

如果确定 data 在某个接口中一定是单一对象，可以临时创建一个不含联合类型的接口，以避免 UTS 的类型推断混淆。

// 专为此接口定义的无联合类型版本  
type ApiResultSingle<T> = {  
    code : number,  
    msg : string,  
    data : T | null // 仅使用单一类型  
}  

uni.request<ApiResultSingle<Test>>({  
  url: 'xxx',  
  method: 'GET',  
  success: (res) => {  
    const result = res.data as ApiResultSingle<Test>;  
    console.log(result.data);   
  }  
});

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

总结

这不是你的用法问题，而是 UTS 在 uni-app 环境下对复杂类型（尤其是联合类型）运行时解析的已知限制。官方文档已说明会对此进行改进。目前使用类型断言 (as) 是绕过此问题最直接有效的方法。