TL;DR

  • Addresses a critical bug in configuration file parsing.
  • Fixes flyway.locations and flyway.configFiles interaction.
  • Ensures reliable database migration setup.

Key Changes

Flyway 12.6.2, released on 2026-05-21, is a targeted patch focusing on a significant configuration issue. The primary change resolves a bug (Issue #4110) where the flyway.locations property was not correctly respected when flyway.configFiles was also in use, and vice-versa. This meant that custom migration script locations defined via flyway.locations or specific configuration files loaded through flyway.configFiles might have been ignored or overridden unexpectedly. Such behavior could lead to an incorrect set of migrations being applied, or even failed migrations, without clear indication of the root cause. This update ensures that both properties are now correctly parsed and applied, restoring expected configuration behavior and preventing silent misconfigurations. No new features or deprecations are noted in this release, making it a focused stability improvement.

For full details, refer to the official release notes.

Impact for QA Teams

This fix is crucial for QA teams relying on specific migration script paths or complex configuration setups across various environments. Prior to this update, QA engineers might have encountered inconsistent database schemas, failed environment provisioning, or spent significant time debugging why expected migrations were not applied. This update prevents scenarios where tests might run against an incorrectly migrated database due to ignored flyway.locations or flyway.configFiles, leading to false positives or negatives. Updating to 12.6.2 ensures consistent and predictable database states, reducing setup failures and improving the reliability of testing workflows.

FAQ

  • Q: What is the main fix in Flyway 12.6.2?
    • A: It fixes a bug where flyway.locations and flyway.configFiles properties were not correctly respected.
  • Q: Is this a mandatory update?
    • A: Yes, if your setup uses both flyway.locations and flyway.configFiles, this update is highly recommended for stable operations.
  • Q: Are there new features in this release?
    • A: No, Flyway 12.6.2 is a patch release focused solely on addressing the configuration bug.