Error
Error Code:
1127
MariaDB Error 1127: Missing Library Symbol
Description
Error 1127 signifies that MariaDB attempted to load a dynamic library, such as a plugin or User-Defined Function (UDF), but failed to locate a required symbol or entry point within that library. This usually occurs during server startup, plugin installation, or when a UDF is called, indicating an issue with the library's integrity, compatibility, or the way the symbol is referenced.
Error Message
Can't find symbol '%s' in library
Known Causes
4 known causesIncorrect Symbol Reference
The symbol name specified in the MariaDB configuration, `CREATE FUNCTION` statement, or plugin definition does not exactly match an exported entry point within the loaded library.
Corrupted or Incompatible Library
The dynamic library file itself (e.g., .so, .dll) is damaged, incomplete, or compiled for a different operating system, architecture, or MariaDB version than the server attempting to load it.
Missing Library Dependencies
The dynamic library MariaDB is trying to load relies on other shared libraries that are not present or accessible in the system's library paths (e.g., `LD_LIBRARY_PATH` on Linux, `PATH` on Windows).
Incorrect File Permissions
MariaDB lacks the necessary read or execute permissions for the dynamic library file or its containing directory, preventing it from being loaded correctly.
Solutions
Coming SoonGeneral Troubleshooting Tips
- Check the error message carefully for specific details
- Review recent changes that might have caused the error
- Search for the exact error code in the official documentation
- Check log files for additional context
- Try restarting the application or service