Commit b32721f
feat(server): stop CE startup when database was previously EE (#41906)
## Summary
Running Appsmith **Community Edition (CE)** against a MongoDB that was
previously operated by Appsmith **Enterprise Edition (EE)** is an
unsupported EE→CE downgrade — CE migrations and CE code then run against
EE-shaped data and can corrupt it. Today this happens silently.
This PR adds a startup guard that detects the condition **before any
Mongock migration runs** and **hard-stops CE startup** with a clear,
operator-facing log message.
## How it works
- **Where:** inside `MongoConfig.mongockInitializingBeanRunner`,
immediately before `buildInitializingBeanRunner()` — guaranteed to run
before any migration, and where the existing `checkForbiddenIds` already
throws-to-abort.
- **CE-only, no EE change:** the guard call is gated on
`DeploymentProperties.getEdition() == "CE"`. An EE build already reports
edition `"EE"` (hardcoded, binary-determined — not read from config), so
EE skips the guard automatically and can never self-block against its
own database. The edition value is shared via
`DeploymentPropertiesCE.EDITION_CE`.
- **Signal (verified against a live EE→CE database and the EE repo):**
query the Mongock audit collection `mongockChangeLog`. EE records its
`@ChangeUnit` migrations in the **parent** package
`com.appsmith.server.migrations.db.` with an `EE` token in the class
name (e.g. `Migration003EE01...`, `Migration042EE01AddWorkflowPlugin`),
plus a legacy `com.appsmith.server.migrations.DatabaseChangelogEE`. CE
migrations live in the `com.appsmith.server.migrations.db.ce.`
subpackage, and CE has **zero** classes directly in the parent `db`
package. So the DB was used by EE iff `mongockChangeLog` holds a
`changeLogClass` under `...migrations.db.` that is **not** under
`...migrations.db.ce.`, or the legacy `DatabaseChangelogEE`. This keys
on the package layout (the same split Mongock scans), not an `EE` name
token, so a CE class like `db.ce.EeThing` is not misread as EE. Prefixes
are anchored and `Pattern.quote`-escaped.
- **On detection (fail-closed):** log an ERROR banner — stable token
`APPSMITH-EE-DOWNGRADE-BLOCKED`, with `changeId`/`changeLogClass` passed
as CR/LF-stripped SLF4J parameters — then throw to abort startup.
- **On query/infrastructure error (fail-open):** log a warning and
proceed, in a catch that does **not** wrap the abort, so a
flaky/locked-down Mongo never bricks a healthy CE instance.
> Detection was corrected mid-branch: an earlier revision used a
`...migrations.db.ee.` prefix, which does not exist in EE and so never
fired. Verified against a real EE→CE database (84 EE records matched, 0
CE false positives; old rule matched 0).
## Testing
- `EnterpriseDowngradeGuardCEImplTest` (embedded Mongo) — **8/8**: real
EE class present → abort; legacy `DatabaseChangelogEE` → abort; CE-only
(db.ce + legacy `DatabaseChangelog0/2`) → pass; empty collection → pass;
missing collection → pass; `FAILED`-state EE record → abort; CE-package
near-misses (`db.ce.EeThing`) → pass; mixed CE+EE database → abort.
- `EnterpriseDowngradeGuardCEImplUnitTest` (Mockito) — **2/2**:
fail-open when the query throws.
- `spotless:check` and `test-compile` clean. Verified live: CE startup
against an EE database now aborts.
## Follow-ups (not in this PR)
1. **CE invariant guard (recommended).** Add a CE test/ArchUnit
assertion that CE migrations only ever live in `...migrations.db.ce.`
(never directly in the parent `db` package), since the guard treats any
parent-`db` class as EE.
2. **Docs:** replace the placeholder runbook URL behind the
`APPSMITH-EE-DOWNGRADE-BLOCKED` token (`// TODO(docs)`).
3. **Optional EE-side test:** assert EE
`DeploymentProperties.getEdition() == "EE"` so an accidentally-dropped
override is caught in CI rather than at startup.
> No EE-repo code change is required — the edition gate keeps the whole
feature in CE.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
## Release Notes
* **New Features**
* Community Edition startup now performs a pre-check for existing
Enterprise Edition migration history to prevent incompatible downgrades.
* If Enterprise migration evidence is detected, startup is stopped with
a clear error message/banner.
* **Bug Fixes**
* Detection includes both current and legacy Enterprise migration
markers and handles mixed scenarios.
* The check is fail-open when audit data can’t be read, avoiding
unnecessary startup blocks.
* **Tests**
* Added unit and integration tests covering blocking vs non-blocking
outcomes, including empty or missing audit data.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
<!-- This is an auto-generated comment: Cypress test results -->
> [!TIP]
> 🟢 🟢 🟢 All cypress tests have passed! 🎉 🎉 🎉
> Workflow run:
<https://github.com/appsmithorg/appsmith/actions/runs/27768419055>
> Commit: 57f2657
> <a
href="https://internal.appsmith.com/app/cypress-dashboard/rundetails-65890b3c81d7400d08fa9ee5?branch=master&workflowId=27768419055&attempt=1"
target="_blank">Cypress dashboard</a>.
> Tags: `@tag.All`
> Spec:
> <hr>Thu, 18 Jun 2026 15:59:26 UTC
<!-- end of auto-generated comment: Cypress test results -->
## Automation
/ok-to-test tags="@tag.All"
---------
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>1 parent 057cc61 commit b32721f
8 files changed
Lines changed: 412 additions & 2 deletions
File tree
- app/server/appsmith-server/src
- main/java/com/appsmith/server
- configurations
- helpers
- ce
- test/java/com/appsmith/server/helpers/ce
Lines changed: 5 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
17 | 21 | | |
18 | 22 | | |
19 | 23 | | |
| |||
22 | 26 | | |
23 | 27 | | |
24 | 28 | | |
25 | | - | |
| 29 | + | |
26 | 30 | | |
27 | 31 | | |
28 | 32 | | |
| |||
Lines changed: 14 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| 8 | + | |
8 | 9 | | |
9 | 10 | | |
10 | 11 | | |
| |||
170 | 171 | | |
171 | 172 | | |
172 | 173 | | |
173 | | - | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
174 | 179 | | |
175 | 180 | | |
176 | 181 | | |
| |||
184 | 189 | | |
185 | 190 | | |
186 | 191 | | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
187 | 200 | | |
188 | 201 | | |
189 | 202 | | |
| |||
app/server/appsmith-server/src/main/java/com/appsmith/server/helpers/EnterpriseDowngradeGuard.java
Lines changed: 5 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
Lines changed: 7 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
Lines changed: 8 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
Lines changed: 119 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
Lines changed: 189 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
0 commit comments