Zion多端应用只需建一套表,因其云原生架构实现页面、API、数据模型解耦,所有端共用同一物理数据库表;表设计需兼容多端语义,UI和行为流按端适配,离线场景通过同步策略生成只读视图。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion开发多端应用时,不需要为不同终端(Web、小程序、App)分别建多套数据表——Zion的底层数据库是统一的,所有端共用同一套表结构。
为什么只建一套表
Zion采用云原生全栈架构,页面、API、数据模型三者解耦。你在「数据」模块中创建的每一张表,都部署在平台托管的共享关系型数据库中,无论Web页面、微信小程序还是即将发布的iOS/Android原生容器,读写操作都指向同一张物理表。
这一步操作起来很简单,直接在左侧导航栏点「数据」→「新建表」,填名称、加字段、设主键即可完成建模。
【关键前提】表设计必须兼容多端业务语义:例如“用户登录态”不能只存session_id(Web可用),还要预留unionid(小程序)、device_id(App)字段;“图片路径”不能写死http://localhost,得用Zion内置的文件服务URL模板{file_url}。
哪些地方需要按端区分
真正需要分端处理的是UI层和行为流,不是数据层。
方法一:用条件式容器做端适配
在页面组件内插入「条件式容器」,设置条件为[当前运行环境]等于weapp,里面放小程序专用按钮;再加一个分支条件为web,放PC端导航菜单。
方法二:用环境变量控制API调用路径
在行为流中调用API时,URL填写${env === 'weapp' ? '/api/wx-login' : '/api/web-login'},后端路由由Zion的API网关自动分发。
注意:不要在表里加“platform_type”字段来硬拆逻辑,这会污染数据一致性,也违背Zion“一次建模、多端复用”的设计原点。
特殊场景:离线缓存需额外建视图
当小程序或App需要本地离线读写时,Zion会在客户端生成SQLite副本,但该副本不新建表,而是通过「同步策略」从云端表派生出轻量视图。
第一步:进入目标表的「同步设置」
第二步:开启「支持离线」开关
第三步:勾选需下推的字段(避免把大文本字段全量同步)
第四步:Zion自动生成_view_offline_{表名}视图,供前端调用offlineDB.query()访问
这个视图仅用于客户端缓存映射,不参与云端数据建模,也不计入你的数据库表计数。


















