> 本文整理自平台文档 docs/wujies/1.x/plugin-dev/advanced/seed-data.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-1de284615335-cover.svg)
这一页解决一件事:表建好了、应用也装上了,页面上的标签 / 下拉项 / 站点名称却还是空的 —— 这些数据写在哪、怎么随应用包发出去。
一句话结论:表建好 ≠ 应用能用。字典、站点配置、示例数据都要写成 migrations/ 里的幂等脚本随包走。 平台不会替你补,也不会在安装时猜你想插什么。
三类必须随包走的数据
| 数据 | 存哪 | 谁读 | 缺了的表现 |
|---|---|---|---|
| 字典 | sys_dict_type + sys_dict_data | 页面标签、筛选下拉(前端 useDict,见 plus-ui/src/utils/dict.ts)、dict-tag 渲染 | 标签空白、筛选项是空的 |
| 站点配置 | sys_config,config_category = 应用编码 | 宿主泛化端点 GET /open/<code>/config | 接口返回空对象:站点名 / logo / 版权 / 备案号全空 |
| 示例 / 必需基础数据 | 应用自己的表 | 应用业务表本身 | 列表页空白,分不清"功能坏了"还是"只是没数据" |
这三样都不在 app.json 里声明(清单的 migrations 字段是文档与回滚预留,当前不参与执行)。 执行方式是目录驱动:安装 / 升级时扫描插件目录的 migrations/,按文件名排序逐个执行。 机制细节见[数据库迁移](/docs/wujies/1.x/plugin-dev/advanced/migrations)。
字典脚本与实体 / Mapper 一样,都放插件工程自己的目录里 —— 平台里没有 *-api 契约模块(数量为 0), 别为了一份字典去找它,见[必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants)。
### 实测缺口
2026-09-14 核对发现:mall 有 11 个自有字典、social 有 4 个,exam / gallery / im / mall 各有一批 sys_config(exam.* / gallery.* / im.* / mall.*)—— 它们当时只存在于开发库, 全新安装的应用全是空标签、/open/<code>/config 返回空对象。现在这几个应用的脚本已经补齐:
| 应用 | 字典类型 / 字典项 | 站点配置行 |
|---|---|---|
wujies-exam | 6 / 16 | 12 |
wujies-mall | 11 / 31 | 12 |
wujies-social | 4 / 19 | — |
wujies-gallery | — | 13 |
wujies-im | — | 12 |
wujies-hello | — | 10 |
(数字来自各应用 migrations/ 里脚本的 INSERT 条数,可自行核对。)
文件命名
wujies/wujies-plugins/wujies-<app>/migrations/
01-create-<app>-tables.sql 建表,纯 DDL(CREATE TABLE IF NOT EXISTS)
0N-create-<app>-seed-data.sql 示例 / 必需基础数据(INSERT IGNORE + 显式主键)
0N-create-<app>-dictionaries.sql 字典(MAX(dict_id)+N / MAX(dict_code)+N + WHERE NOT EXISTS)
0N-create-<app>-website-config.sql 站点配置(MAX(config_id)+N + WHERE NOT EXISTS)
改过 01 的存量部署要先跑 wujies-platform/script/sql/update/app_market_app_seed_split_repair.sql, 再升级该应用 —— 见[升级与补丁](/docs/wujies/1.x/deploy/upgrade)。
- 编号只表示执行顺序,取下一个空号 —— 别为了整齐重排既有脚本;
.sql必须是migrations/的顶层文件:打包只扫顶层,子目录里的会被告警跳过;- 已执行过的脚本内容不能再改(账本按
(app_code, script)比 SHA-256),要变更就新增脚本。
范例应用 wujies-hello 是最小样本:01 一张表、02 两条示例数据、03 十条站点配置。 三条脚本的完整效果可以在菜单「Hello 示例 → 插件开发范例」里对照,源码索引见[跟着 hello 读源码](/docs/wujies/1.x/plugin-dev/demo)。
站点配置:config_category = 应用编码
把行写进 sys_config 之后,不需要自己写"读配置"的接口。 宿主的泛化端点 cn.wujies.system.controller.OpenWebsiteConfigController (@RequestMapping("/open/{code}/config"),类上有 @SaIgnore)会按 config_category 读出来 —— 宿主不认识具体应用,新应用接进来不用改宿主一行。
范本:wujies/wujies-plugins/wujies-hello/migrations/03-create-hello-website-config.sql。 三条平台约定照抄,别自己发明:
1. 主键用 MAX(config_id)+N,不用自增 —— sys_config 是平台表,主键号段要给平台留着; 2. 每条都带 WHERE NOT EXISTS(按 config_key + tenant_id 判重)⇒ 幂等,重装 / 升级不重复插; 3. 子查询要包一层派生表 (SELECT ... FROM sys_config) c —— MySQL 不允许在 INSERT 的子查询里直接引用正在插入的那张表,不包会报 You can't specify target table 'sys_config' for update in FROM clause。
返回结构由 cn.wujies.system.controller.vo.OpenWebsiteConfigVo 定死,两块:
| 块 | 键 | 说明 |
|---|---|---|
| 8 个基础字段 | logo / favicon / name / nameEn / backgroundImage / description / copyright / icp | 各占一个属性。前三个库里存的是 OSS 行 id(可逗号分隔多个),读的时候换成可访问 URL,空值返回 null |
settings | 其余 <code>.* 全部 | 原样透传,键去掉 <code>. 前缀。前端各页面自己决定读哪些开关,宿主不需要认识它们 |
两个容易踩的点:
logo/favicon/backgroundImage一律置空:开发库里存的是导出机器的 OSS 行 id,换一套部署就是死引用 —— 留空由管理员在「系统配置」里自己上传;- 配置按租户隔离:种子脚本只写默认租户
'000000',多租户部署要给每个租户各补一份(或让管理员在界面上改)。
wujies-hello 里有个 GET /open/hello/config-via-plugin,它是反面示范 —— 用来对照"插件自己读 ConfigService 再包一层"是多余的。真实场景什么都不用做: 配置行写完,GET /open/<code>/config 就自动可用(源码注释里也是这么写的)。
字典:类型与字典项一起发
范本:wujies/wujies-plugins/wujies-exam/migrations/02-create-exam-dictionaries.sql(生成器的参考风格就是它)、 wujies/wujies-plugins/wujies-mall/migrations/02-create-mall-dictionaries.sql。
| 表 | 判重键 | 主键 |
|---|---|---|
sys_dict_type | (dict_type, tenant_id) | MAX(dict_id)+N |
sys_dict_data | (dict_type, dict_value, tenant_id) | MAX(dict_code)+N |
- 脚本开头先取两个基线(
SET @base_dict_id := .../SET @base_dict_code := ...),序号顺着往下排,避免与平台已有字典撞号; - 字典类型名用
<code>_前缀(exam_question_type/mall_order_status/social_*)—— 彻底卸载时平台就是
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-1de284615335-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。