windyboy
09b53c77bb
收报扫描不再以 DATE_PROCESSED 为谓词：终态而未回填的行（解码失败死信等）会永久占据 有限批次，累积到 claim-batch 后收报整体停摆（US-01 条目 3 / message-lifecycle §5.3）。 ingress/InboxPoller.kt：按 ID 区间升序有界读取（ID > W），水位落 INBOX_CURSOR 并与入队 同一 PG 事务推进（中断后重扫补建）；遇空洞即停，空洞超过 pipeline.max-commit-delay 判定 为永久并放行——否则水位永久停摆于一次自增回滚留下的空位。删除 InboxEnqueue（改由 insertIfAbsent 幂等入队）与 poller 内的回填扫描（消除 ingress→jobs 反向依赖）。 infra/persistence：端口按事实重画为 readRange/maxId/markProcessedIfUnmarked，标记 UPDATE 带 DATE_PROCESSED IS NULL 守卫，只把空标写为已处理（§11 单调，重复执行无副作用）。 回填事实并入 PROC_STATE（RECEIVED_AT/BACKFILL_AT/NEXT_AT/ATTEMPTS/ERROR），BACKFILL_TODO 随 V2 迁移下线；终态与回填意图是同一条 UPDATE，由处理器在自己的业务事务内落库， message-lifecycle §4 登记的两个崩溃窗口（提交后回填前崩溃、待办二次落账失败）不再是缺口。 processing/BackfillService.kt（取代 BackfillSweepJob）：终态提交后立即尝试一次，失败按 30s→15min 指数退避重试；扫描条件「终态 + 未确认标记 +（已到期 或 接收时间早于 NOW − R）」 使 §5.2 的超期期限 R 覆盖退避，中间态永不补写。死信同样可补写——回填只需消息 ID， 不再依赖 META。Pump 改用可注入 Clock。 infra/health：InboxLifecycleHealthIndicator 输出积压条数、最老未处理信龄、未回填终态数与 水位滞后（OPS-2 / §5.3 验收）。预计消化时长需吞吐采样，留待接入指标注册表时补。 配置：pipeline.max-commit-delay / overdue-backfill / backfill-batch、mailbox.processed-value （Q2/Q6/Q7 未书面确认前取保守初值，不得为提速下调）。 不变量回归测试：死信不阻断后续发现、水位遇空洞即停与老化放行、终态+意图同事务、 超期 R 覆盖退避、中间态不补写、标记单调；InboxLifecycleJdbcSqlTest 以 H2 的 PostgreSQL 兼容模式直连验证上述 SQL 语义（不依赖 docker）。libs.h2 由 testRuntimeOnly 提为 testImplementation 以支持该用例。 验证：gradle clean test --offline → 78 tests / 0 failures / 1 skipped （PG Testcontainers 集成用例在本机无 docker 时按既有约定 assumeTrue 跳过）。
80 lines
3.1 KiB
Kotlin
80 lines
3.1 KiB
Kotlin
plugins {
|
||
alias(libs.plugins.kotlin.jvm)
|
||
alias(libs.plugins.kotlin.ksp) // U01：Kotlin 注解处理（无 KSP/kapt 则 Micronaut 不生成 BeanDefinition）
|
||
alias(libs.plugins.micronaut.application)
|
||
}
|
||
|
||
group = "com.gzzn.omms"
|
||
version = "2.0.0-SNAPSHOT"
|
||
|
||
repositories {
|
||
mavenCentral()
|
||
}
|
||
|
||
java {
|
||
toolchain {
|
||
// Micronaut 5.1 系构件要求 JVM 25+（实测依赖解析结论，修正计划的 JDK 21 口径）
|
||
languageVersion = JavaLanguageVersion.of(25)
|
||
}
|
||
}
|
||
|
||
kotlin {
|
||
jvmToolchain(25)
|
||
compilerOptions {
|
||
// Keep Jackson XML annotations on both Kotlin constructor parameters and properties.
|
||
freeCompilerArgs.add("-Xannotation-default-target=param-property")
|
||
}
|
||
}
|
||
|
||
micronaut {
|
||
runtime("netty")
|
||
testRuntime("junit5")
|
||
processing {
|
||
incremental(true)
|
||
// U01（N23）：processing.annotations 语义是“注解所在包”的过滤，业务包路径不匹配任何 Micronaut
|
||
// 注解，已移除（取默认），避免增量注解处理被错误过滤；注解处理由 kotlin-ksp + micronaut-inject-kotlin 承担。
|
||
}
|
||
}
|
||
|
||
dependencies {
|
||
// U01：Micronaut Kotlin 注解处理器（KSP），生成 @Singleton/@Controller/@ConfigurationProperties 的 BeanDefinition
|
||
ksp(libs.micronaut.inject.kotlin)
|
||
|
||
implementation(libs.bundles.micronaut.runtime)
|
||
implementation(libs.micronaut.data.jdbc)
|
||
implementation(libs.micronaut.jdbc.hikari)
|
||
implementation(libs.micronaut.flyway)
|
||
implementation(libs.micronaut.redis.lettuce)
|
||
implementation(libs.micronaut.kafka)
|
||
implementation(libs.micronaut.discovery.eureka)
|
||
implementation(libs.jackson.dataformat.xml)
|
||
implementation(libs.jackson.module.kotlin)
|
||
implementation(libs.logstash.logback.encoder)
|
||
|
||
runtimeOnly(libs.mysql.connector.j)
|
||
runtimeOnly(libs.postgresql)
|
||
runtimeOnly("org.flywaydb:flyway-database-postgresql:12.11.0")
|
||
// ACM2-11：datasources.reference（21 类静态主数据独立 PG 库）驱动 org.postgresql:postgresql
|
||
// 随阶段 6 实装加入（当前 reference enabled=false 不加载；版本由 micronaut-platform BOM 钉 ~42.7）
|
||
runtimeOnly(libs.snakeyaml) // U02：显式版本入 catalog（原无版本号依赖 BOM 覆盖，snakeyaml 不在 micronaut BOM 内）
|
||
|
||
testImplementation(libs.junit.jupiter)
|
||
// U03：配置绑定回归测试的测试库（内存 datasource，冒烟用）；
|
||
// V2 起 InboxLifecycleJdbcSqlTest 以 H2 的 PostgreSQL 兼容模式直连验证生命周期 SQL 语义
|
||
testImplementation(libs.h2)
|
||
testImplementation("io.micronaut.test:micronaut-test-junit5")
|
||
testImplementation("org.jetbrains.kotlin:kotlin-test")
|
||
// P3-A（ACM2-29）：无外部 PG 时 JDBC 集成测试自动起隔离容器；有 MSGX_PG_* 环境变量时不启用
|
||
testImplementation("org.testcontainers:postgresql:1.20.4")
|
||
}
|
||
|
||
application {
|
||
// Kotlin 顶层 main（Application.kt）→ JVM 主类为 ApplicationKt；
|
||
// 不声明则 ./gradlew run 报 "No main class specified"、installDist 产出的启动脚本主类为空。
|
||
mainClass.set("com.gzzn.omms.msgexchange.ApplicationKt")
|
||
}
|
||
|
||
tasks.test {
|
||
useJUnitPlatform()
|
||
}
|