90%的uniCloud.callFunction报错或返回空/undefined，源于云环境未就位：函数未部署、空间未关联、H5未开本地开关；需检查uniCloud文件夹是否存在、服务空间是否“已就绪”、右键上传部署、name与文件夹名严格一致、H5勾选“使用本地云函数”。

前端调用 uniCloud.callFunction 报错或返回空、undefined、cloud function not found，90% 不是代码写错了，而是云环境没真正就位——函数没部署、空间没关联、H5 没开本地开关，这三件事漏一个，调用就断在第一步。

uniCloud.callFunction 为什么是 undefined

这是最典型的“环境缺失”信号。不是 SDK 加载失败，而是项目压根没接入 uniCloud 生态。

• 检查项目根目录下是否存在 uniCloud 文件夹：没有 → 说明没关联云空间，HBuilderX 不会自动生成
• 打开 DCloud 控制台，确认已创建状态为「已就绪」的服务空间（腾讯云填 tcb，阿里云填 aliyun）
• HBuilderX 中右键项目 →「uniCloud」→「关联云空间」，选中刚创建的空间；此时才会生成 uniCloud/cloudfunctions 和 uniCloud/database
• uniCloud.init 必须显式调用，且传 spaceId 和 provider（值来自控制台服务空间详情页），只写 {"provider": "aliyun"} 不生效

name 参数为什么总报 function not found

部署动作没真正发生，或者调用参数与部署结构不匹配。云函数名不是文件名、不是 JS 函数名，而是文件夹名，且大小写敏感。

• 必须右键云函数所在文件夹（如 uniCloud/cloudfunctions/hello）→「上传部署」，仅保存 index.js 不生效
• 前端 name 必须与云函数文件夹名**完全一致**：hello ≠ Hello ≠ hello-world
• H5 端调试时，若未开启「H5 使用本地云函数」（manifest.json → H5 配置 → 勾选），请求会走浏览器 CORS 校验而被拦截，表现为网络错误而非函数不存在
• 微信小程序真机调试前，确保 HBuilderX 已切换到对应服务空间：右键 uniCloud 目录 →「切换服务空间」

调用后 res.result 拿不到数据或报错

成功进入 success 回调，不代表业务逻辑没问题。常见陷阱在云函数返回结构、错误处理和权限配置上。

HISUI 前端框架开发指南（IRIS版）

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。

下载

• 云函数里 return 的内容，才是前端 res.result 的值；不要在云函数里写 console.log 就以为返回了
• 如果云函数抛出异常（如 throw new Error('xxx')），前端会进 fail 回调，errCode 是字符串 "systemError"，errMsg 才是具体错误信息
• 数据库操作必须封装在云函数中；前端禁止直连，即使能调用 uniCloud.database()，也因权限未开而返回空数组或 permission denied
• 数据库表权限需在 uniCloud 控制台手动配置：进「数据库」→ 点表名 →「表结构」→「权限」标签页，把 "read": false 改成 "read": true 或更细粒度规则

如何安全地做登录态透传和错误拦截

前端调用本身不处理登录态跳转或统一错误响应，这些得靠拦截器主动干预，否则 then 还会继续执行，造成渲染错乱。

• 用 uniCloud.addInterceptor('callFunction', { success(res) {...} }) 拦截成功响应，比如检测 res.result?.errCode === 401 时清除 token 并跳转登录页
• 必须 throw new Error('login_required')，让当前这次 callFunction 的 Promise 立即 reject，上层才能统一 catch；只 uni.navigateTo 不 throw，then 仍会执行
• fail 拦截的是底层网络异常：断网、超时、服务不可达、CORS 被拒（尤其 H5 端未开启「本地云函数」）、云函数名不存在等，这些不会进 success，必须单独处理

最容易被忽略的其实是部署动作本身——右键上传不是仪式感，是真实把代码推到云端的唯一方式；还有 H5 端那个开关，不开它，你在浏览器里写的每行 callFunction 都在跨域悬崖边上反复试探。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！