MariaDB server is a community developed fork of MySQL server. Started by core members of the original MySQL team, MariaDB actively works with outside developers to deliver the most featureful, stable, and sanely licensed open SQL server in the industry.
Find a file
Brandon Nesterenko b102f6146f MDEV-29981: Replica stops with "Found invalid event in binary log"
Replication can stop in error if a Heartbeat log event is sent to a
replica during rotation. There are two bugs at play:

  1. Prior to MDEV-30128 (added in 11.0), there is a bug when checking
     legacy events. When the replica rotates its relay logs, it
     initializes its Format_description_log_event with binlog version 3
     (this is hard-coded). So immediately after rotation (and until a
     new Format_descriptor with binlog_format 4 is sent from the
     master), the IO thread is expecting binlog_format 3 (i.e. it will
     call queue_old_event() for incoming events). This invalidates any
     events that are sent with an event type higher than 14. In theory,
     we wouldn't expect any events to be sent in-between a rotate and
     the next format descriptor log event, but if a long enough period
     of time passes between then, the primary will generate and send a
     Heartbeat event (of type 27). In such case, the slave will see the
     heartbeat event of type 27, see it is higher than 14, and result
     in an error mentioning 'Found invalid event in binary log', with
     the expected log coordinates of the new log (which is
     optimistically populated from the Rotate log event, not the new
     event).

  2. In all versions of MariaDB (11.0+), there is a bug when checking
     the state of a Heartbeat log event, in that it doesn't consider a
     rotated binary log. The check is meant to ensure that the
     heartbeat provided by the master (i.e. the state of the master) is
     greater than or equal to the state of the slave. In other words,
     it checks that the slave isn't ahead of the master. However, if
     the filename provided by the master heartbeat event is different
     than the filename saved for the slave's state, the check always
     fails. This is broken, because when the master rotates its logs,
     the new binary log file will have a different filename (i.e. an
     incremented index counter suffix). For example, if the master
     rotates its binary logs from master-bin.000002 to
     master-bin.000003, master-bin.000003 is ahead of
     master-bin.000002, but the slave will see a difference between the
     filenames and fail the check.

To fix the first problem, this patch disallows passing a heartbeat
event into queue_old_event (which is the source of the error, as it
tries to parse a heartbeat log event). This function (queue_old_event)
was removed with MDEV-30128, so bypassing it for heartbeat events is
not consequential (and it is already also done for
Format_description_events, which are not supported in old binlog file
versions). Note that backporting all of MDEV-30128 was also considered,
but this is less risky for GA.

To fix the second problem, we simply ignore heartbeat events on the
slave if the filenames don't match. This is because during rotation,
it can appear that the slave is ahead of the master, which breaks the
validity of the check (i.e. the check is to ensure the master is
ahead of the slave).

Additionally note that this patch restores a heartbeat check that was
incorrectly removed in 780db8e252

Reviewed-by: Andrei Elkin <andrei.elkin@mariadb.com>
Signed-off-by: Brandon Nesterenko <brandon.nesterenko@mariadb.com>
2025-08-23 15:07:06 -06:00
.github MDEV-36885 Windows/ARM64 - build and test on CI 2025-05-26 23:07:57 +03:00
BUILD Merge branch '10.6' into 10.11 2024-04-26 08:02:49 +02:00
client Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
cmake Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
dbug Merge 10.6 into 10.8 2023-02-10 13:43:53 +02:00
debian Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
Docs Fixed some typos in optimizer_costs.txt 2023-03-28 18:41:09 +11:00
extra Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
include Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
libmariadb@b790c6c149 Connector/C 3.4.7 2025-07-27 15:44:07 +02:00
libmysqld Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
libservices Merge 10.6 into 10.11 2024-02-08 15:04:46 +02:00
man MDEV-33556: Document mariadb-import --parallel option in man page 2024-10-15 13:04:39 +11:00
mysql-test MDEV-29981: Replica stops with "Found invalid event in binary log" 2025-08-23 15:07:06 -06:00
mysys Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
mysys_ssl MDEV-35838 libressl support differences in CRYPTO_set_mem_functions 2025-01-14 12:13:22 +11:00
plugin Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
randgen/conf Group commit for maria engine. 2010-02-12 15:12:28 +02:00
scripts Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
sql MDEV-29981: Replica stops with "Found invalid event in binary log" 2025-08-23 15:07:06 -06:00
sql-bench Updated sql-bench to run with PostgreSQL 14.9 2023-09-09 15:14:45 +03:00
sql-common MDEV-37143 mariabackup fails on Windows with "SSL certificate is self-signed" 2025-07-04 23:29:33 +03:00
storage Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
strings Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
support-files Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
tests Merge branch '10.11' into 11.4 2025-04-26 10:53:02 +02:00
tpool Merge branch '10.6' into 10.11 2025-07-28 18:06:31 +02:00
unittest Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
vio Merge branch '10.11' into 11.4 2025-06-17 09:50:22 +02:00
win Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
wsrep-lib@e55f01ce1e MDEV-36422 Build fails with cmake 4.0.0 due to wsrep 2025-04-10 13:05:19 +02:00
zlib Merge branch 'merge-zlib' (1.3.1) into 10.4 2024-04-26 13:50:03 +02:00
.clang-format Remove duplicate key "Language" from .clang-format 2024-04-17 16:52:37 +02:00
.gitattributes Merge branch '10.5' into 10.6 2022-02-03 17:01:31 +01:00
.gitignore Merge branch '10.11' into 11.4 2025-06-17 09:50:22 +02:00
.gitlab-ci.yml Merge branch '11.1' into 11.2 2024-08-03 09:50:16 +02:00
.gitmodules Merge remote-tracking branch '10.4' into 10.5 2023-03-31 21:32:41 +02:00
appveyor.yml Merge branch '10.11' into 11.4 2025-04-26 10:53:02 +02:00
BUILD-CMAKE Minor spelling fixes in code comments, docs and output 2018-01-12 16:49:02 +02:00
CMakeLists.txt Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
CODING_STANDARDS.md Explicitly recommend target branches in CODING_STANDARDS 2023-12-14 16:32:42 +00:00
config.h.cmake Merge branch '10.11' into 11.4 2025-07-28 19:40:10 +02:00
configure.cmake Merge branch '11.2' into 11.4 2024-10-30 15:11:17 +01:00
CONTRIBUTING.md Add CODING_STANDARDS.md file 2023-02-03 15:47:17 +11:00
COPYING Update FSF Address 2019-05-11 21:29:06 +03:00
CREDITS Update sponsors 2024-08-12 09:32:30 +01:00
INSTALL-SOURCE Update AskMonty and Atlassian references to MariaDB 2016-03-08 15:24:01 +02:00
INSTALL-WIN-SOURCE Update AskMonty and Atlassian references to MariaDB 2016-03-08 15:24:01 +02:00
KNOWN_BUGS.txt Changed some MySQL names in messages to MariaDB 2018-12-09 20:49:05 +02:00
README.md Merge branch '10.11' into 11.1 2024-05-31 10:54:31 +10:00
SECURITY.md Create SECURITY.md 2023-06-05 08:28:06 +10:00
THIRDPARTY Merge branch '10.6' into 10.11 2024-01-30 08:17:58 +01:00
VERSION bump the VERSION 2025-08-06 17:22:59 -04:00

Code status:

  • Appveyor CI status ci.appveyor.com

MariaDB: The innovative open source database

MariaDB was designed as a drop-in replacement of MySQL(R) with more features, new storage engines, fewer bugs, and better performance.

MariaDB is brought to you by the MariaDB Foundation and the MariaDB Corporation. Please read the CREDITS file for details about the MariaDB Foundation, and who is developing MariaDB.

MariaDB is developed by many of the original developers of MySQL who now work for the MariaDB Corporation, the MariaDB Foundation and by many people in the community.

MySQL, which is the base of MariaDB, is a product and trademark of Oracle Corporation, Inc. For a list of developers and other contributors, see the Credits appendix. You can also run 'SHOW authors' to get a list of active contributors.

A description of the MariaDB project and a manual can be found at:

https://mariadb.org

https://mariadb.com/kb/en/

https://mariadb.com/kb/en/mariadb-vs-mysql-features/

https://mariadb.com/kb/en/mariadb-versus-mysql-compatibility/

https://mariadb.com/kb/en/new-and-old-releases/

Getting the code, building it and testing it

Refer to the following guide: https://mariadb.org/get-involved/getting-started-for-developers/get-code-build-test/ which outlines how to build the source code correctly and run the MariaDB testing framework, as well as which branch to target for your contributions.

Help

More help is available from the Maria Discuss mailing list https://lists.mariadb.org/postorius/lists/discuss.lists.mariadb.org/ and MariaDB's Zulip instance, https://mariadb.zulipchat.com/

Licensing


MariaDB is specifically available only under version 2 of the GNU General Public License (GPLv2). (I.e. Without the "any later version" clause.) This is inherited from MySQL. Please see the README file in the MySQL distribution for more information.

License information can be found in the COPYING file. Third party license information can be found in the THIRDPARTY file.


Bug Reports

Bug and/or error reports regarding MariaDB should be submitted at: https://jira.mariadb.org

For reporting security vulnerabilities, see our security-policy.

The code for MariaDB, including all revision history, can be found at: https://github.com/MariaDB/server