P0-3: 修 app create DB 失败自动 fallback --skip-db (testspace 验证通过)

This commit is contained in:
ssw committed 2026-07-15 22:49:41 +08:00
1 parent 070a4206ab
commit a5c3bdc32e
1 file changed
+61 -43
+61 -43
View File
@@ -79,9 +79,61 @@ export function buildAppCreateCommand(): Command {
.option('--skip-db', '跳过 ssw-common 真建 DB (用户已建好)', false)
.option('--json', '原始 JSON 输出', false)
.action(async (opts: CreateOpts) => {
const dbName = opts.dbName || opts.appCode
log.info(`开始创建应用: ${opts.appCode} (${opts.appName})`)
log.dim(` dbName=${dbName}, force-rebuild=${!!opts.forceRebuild}, skip-db=${!!opts.skipDb}, skip-grant=${!!opts.skipGrant}`)
await runCreate(opts)
})
installAiHelpHook(cmd, {
purpose: '真·创建 JNPF 应用 (System+DB+DataSource+授权+重登, 端到端 0 差错). v3.0+ step 1/4 走 webapi/system 镜像',
required: {
'--appCode': '应用编码 (英文, 唯一)',
'--appName': '应用中文名称',
},
optional: {
'--dbName': '数据库名 (默认同 appCode)',
'--account': '管理员账号 (默认 admin)',
'--password': '管理员密码 (默认 123456)',
'--force-rebuild': '已存在 DataSource 时强制删旧重建',
'--skip-grant': '跳过 saveAppAuthorization (默认走全员)',
'--skip-db': '跳过真建 DB + DataSource (用户已建好)',
'--json': '原始 JSON 输出',
},
example: [
'dacli app create --appCode=tdss --appName=可信数据空间增强版',
'dacli app create --appCode=tdss --appName=可信数据空间增强版 --dbName=tdss_db',
'dacli app create --appCode=tdss --appName=可信数据空间增强版 --force-rebuild',
].join('\n'),
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/appCenter/Form.vue + appConfig/appAuth/index.vue',
api: 'POST /system/System + /common/dblinkExt/{createDatabase,create} + /system/System/saveAppAuthorization (step 1/4 镜像 webapi/system)',
ref: 'docs/dacli/ssw-dacli/src/main/java/ssw/dacli/commands/InitAppCommand.java (Java 借鉴)',
},
notes: [
'**v3.0+ P0 (regression audit 2026-06-29)**: step 1/4 webapi 镜像化',
' step 1: getSystemList + create 走 webapi/system (web 端同名)',
' step 4: saveAppAuth 走 webapi/system (web 端同名)',
' step 2/3: ssw-common 特有 (web 无等价), 保留 c.postJson',
'**幂等**: 应用/DataSource 已存在则复用 (除 --force-rebuild)',
'**ssw-common 必需**: 真建 DB 走 /common/dblinkExt/createDatabase, 未加载时 --skip-db 跳过',
'**yml**: 不动文件, ssw-common 走 spring.datasource.* 默认 (host/port/user/pwd)',
'**P0-3 (2026-07-15)**: step 2 createDatabase 报 code=400 数据库创建失败时, 自动 fallback --skip-db 重试整流程, 无需用户介入',
'**0 差错检查**: 流程末尾自动切换登录 + 保存 token, 失败留警告但不退出',
],
})
return cmd
}
/**
* runCreate — step 0/1/2/3/4/5 真·创建 JNPF 应用的核心流程.
*
* P0-3 (2026-07-15): 提取为独立函数, 让 step 2 DB 创建失败时自动 fallback --skip-db 重试整流程.
* 守卫: __skipDbRetried 内部标记, 防止无限递归 (只重试 1 次).
*/
async function runCreate(opts: CreateOpts): Promise<void> {
// P0-3 守卫: 防止 fallback 无限递归
const __skipDbRetried = (opts as CreateOpts & { __skipDbRetried?: boolean }).__skipDbRetried
const dbName = opts.dbName || opts.appCode
log.info(`开始创建应用: ${opts.appCode} (${opts.appName})`)
log.dim(` dbName=${dbName}, force-rebuild=${!!opts.forceRebuild}, skip-db=${!!opts.skipDb}, skip-grant=${!!opts.skipGrant}, retried=${!!__skipDbRetried}`)
// === step 0 拿当前 token (复用登录态; 无 token 时强制 admin 登录拿平台 token) ===
// === 0. 拿当前 token (复用登录态; 无 token 时强制 admin 登录拿平台 token) ===
@@ -145,6 +197,7 @@ export function buildAppCreateCommand(): Command {
// === step 2 创建 DB (ssw-common /dblinkExt/createDatabase) ===
// dbType 自动从 yml 的 spring.datasource.db-type 推断 (默认连接, 避免硬编码)
// P0-3 (2026-07-15): code=400 数据库创建失败 (DB 已存在/权限不足) 自动 fallback --skip-db 重试
let dbLinkId = ''
if (!opts.skipDb) {
const dbType = loadDbProfile().dbType
@@ -155,8 +208,12 @@ export function buildAppCreateCommand(): Command {
} else if (r2.code === 404) {
log.warn(` ⚠ ssw-common 未加载, 跳过真建 DB. DataSource 也跳过, 请手动建.`)
opts.skipDb = true
} else if (!__skipDbRetried) {
// P0-3: DB 创建失败, 自动 fallback --skip-db 重试整流程 (DB 已存在/权限不足等场景)
log.warn(` ⚠ createDatabase 失败 (code=${r2.code} ${r2.msg}), 自动 fallback --skip-db 重试`)
return runCreate({ ...opts, skipDb: true, __skipDbRetried: true } as CreateOpts)
} else {
log.error(` ✗ createDatabase 失败: code=${r2.code} ${r2.msg}`)
log.error(` ✗ createDatabase 失败 (已 fallback --skip-db 仍失败): code=${r2.code} ${r2.msg}`)
process.exit(1)
}
} else {
@@ -269,43 +326,4 @@ export function buildAppCreateCommand(): Command {
log.info(` dacli form create --enCode=... --table=...`)
log.info(` 浏览器: http://nginx/jnpf_app_${opts.appCode}`)
}
})
installAiHelpHook(cmd, {
purpose: '真·创建 JNPF 应用 (System+DB+DataSource+授权+重登, 端到端 0 差错). v3.0+ step 1/4 走 webapi/system 镜像',
required: {
'--appCode': '应用编码 (英文, 唯一)',
'--appName': '应用中文名称',
},
optional: {
'--dbName': '数据库名 (默认同 appCode)',
'--account': '管理员账号 (默认 admin)',
'--password': '管理员密码 (默认 123456)',
'--force-rebuild': '已存在 DataSource 时强制删旧重建',
'--skip-grant': '跳过 saveAppAuthorization (默认走全员)',
'--skip-db': '跳过真建 DB + DataSource (用户已建好)',
'--json': '原始 JSON 输出',
},
example: [
'dacli app create --appCode=tdss --appName=可信数据空间增强版',
'dacli app create --appCode=tdss --appName=可信数据空间增强版 --dbName=tdss_db',
'dacli app create --appCode=tdss --appName=可信数据空间增强版 --force-rebuild',
].join('\n'),
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/appCenter/Form.vue + appConfig/appAuth/index.vue',
api: 'POST /system/System + /common/dblinkExt/{createDatabase,create} + /system/System/saveAppAuthorization (step 1/4 镜像 webapi/system)',
ref: 'docs/dacli/ssw-dacli/src/main/java/ssw/dacli/commands/InitAppCommand.java (Java 借鉴)',
},
notes: [
'**v3.0+ P0 (regression audit 2026-06-29)**: step 1/4 webapi 镜像化',
' step 1: getSystemList + create 走 webapi/system (web 端同名)',
' step 4: saveAppAuth 走 webapi/system (web 端同名)',
' step 2/3: ssw-common 特有 (web 无等价), 保留 c.postJson',
'**幂等**: 应用/DataSource 已存在则复用 (除 --force-rebuild)',
'**ssw-common 必需**: 真建 DB 走 /common/dblinkExt/createDatabase, 未加载时 --skip-db 跳过',
'**yml**: 不动文件, ssw-common 走 spring.datasource.* 默认 (host/port/user/pwd)',
'**0 差错检查**: 流程末尾自动切换登录 + 保存 token, 失败留警告但不退出',
],
})
return cmd
}