4094
MariaDBERRORCommonHIGH confidence

InnoDB tablespace encryption key inaccessible during upgrade

Production Risk

High — Inaccessible encryption keys block the upgrade and leave the database in an intermediate state.

Why it happens
  1. 1The keyring plugin is not loaded or the key has been rotated/deleted.
  2. 2The keyring backend (vault, file) is unreachable during upgrade.
  3. 3The keyring configuration changed between the old and new MySQL version.

Fix 1

Ensure the keyring plugin is loaded before upgrading

Why this works

Add the keyring plugin to early-plugin-load in my.cnf and verify the key is accessible.

Fix 2

Decrypt tablespaces before upgrading if keyring migration is required

Decrypt tablespaces before upgrading if keyring migration is required
ALTER TABLE t ENCRYPTION=N;

Why this works

Removing encryption before the upgrade avoids keyring dependency during the upgrade process.

What not to do

Sources
Official documentation ↗

MySQL 8.0 — 4094 ER_INNODB_TS_ENCRYPTION_INACCESSIBLE_UPGRADE

Content generated with AI assistance and reviewed for accuracy. Found an error? hello@errcodes.dev

← All MariaDB errors