是的,Zion平台在首次部署或初始化项目时会自动创建users表及关联的roles、permissions、user_roles等基础表,字段根据所选身份认证模式(如邮箱密码+短信验证码或仅OAuth)动态生成,无需手动建表或迁移工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Zion平台在创建新项目时会自动初始化一套基础用户体系,包括登录、注册、权限控制等核心功能所依赖的数据库表结构。
用户表是否自动生成
是的,Zion会在首次部署或初始化项目时,【自动创建 users 表及关联的 roles、permissions、user_roles 等基础表】。这些表不需手动编写建表语句,也不依赖外部迁移工具。
生成依据来自项目初始化时选择的「身份认证模式」:若选「邮箱密码+短信验证码」,则表中自动包含 email、phone、password_hash、verify_code_expires_at 字段;若选「仅 OAuth 第三方登录」,则不会生成 password_hash 字段,但会添加 provider、provider_id、access_token_encrypted 等列。
如何确认用户表已生成
进入 Zion 控制台 →「数据管理」→「数据库结构」,找到默认 schema(通常是 public 或 main),展开后可见 users 表已存在且状态为「已同步」。
若使用 CLI 初始化项目,执行 zion db:status 命令,输出中会出现 users: migrated (auto) 标识。
【注意:该表不可删除,否则登录流程将彻底中断,且 Zion 不提供重建入口】。
能否修改自动生成的 users 表
方法一:通过控制台字段编辑器增删字段
直接在 users 表界面点击「添加字段」,输入字段名(如 avatar_url)、类型(VARCHAR(255))、是否允许为空。保存后立即生效,Zion 会自动执行 ALTER TABLE。
方法二:通过 SQL 模式手动执行 DDL
切换至「SQL 查询」页,运行 ALTER TABLE users ADD COLUMN nickname VARCHAR(50) DEFAULT '';。此方式支持复杂变更,如添加唯一索引或 CHECK 约束。
方法三:在项目配置中声明扩展字段(推荐)
打开项目根目录下的 zion.config.yml,在 auth: 节点下添加:user_fields: nickname: string department_id: integer
下次部署时,Zion 会比对配置与当前表结构,自动补全缺失字段。


















