EC
1687
MySQLERRORNotablePluginHIGH confidence

Plugin cannot be uninstalled because it is required

Production Risk

Low — operation is refused; no state changes occur.

What this means

An attempt was made to uninstall a plugin that is marked as mandatory or is currently in use by one or more active components, preventing its removal.

Why it happens
  1. 1The plugin is declared with PLUGIN_LICENSE_GPL or marked as PLUGIN_OPT_NO_UNINSTALL.
  2. 2Another loaded plugin or component depends on it.
How to reproduce
trigger — this will error
trigger — this will error
UNINSTALL PLUGIN validate_password;

expected output

ERROR 1687 (HY000): Plugin 'validate_password' cannot be uninstalled now. It is required by another plugin.

Fix

Uninstall the dependent plugin first

Uninstall the dependent plugin first
-- Identify dependents, remove them first, then retry:
UNINSTALL PLUGIN dependent_plugin;
UNINSTALL PLUGIN validate_password;

Why this works

Removing the dependency chain allows the target plugin to be unloaded.

What not to do

✕

Sources
Official documentation ↗

MySQL 8.0 — 1687 ER_PLUGIN_CANNOT_BE_UNINSTALLED

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

← All MySQL errors