Flyway版本含非法字符异常求助：Maven集成数据库迁移问题

首先，从你遇到的错误Invalid version: V.1来看，Flyway似乎没有正确识别你配置的sqlMigrationPrefix和sqlMigrationSeparator，反而在用默认规则解析文件名，导致把V.1当成了版本号（默认前缀是V，拆分后得到的版本部分包含非法字符）。下面是一步步的排查方向：

1. 确认你的Maven配置是否真的生效 #

很多时候配置不生效是问题根源，你可以通过以下方式验证：

• 运行命令：mvn help:describe -Dplugin=flyway -Ddetail，在输出里找到sqlMigrationPrefix和sqlMigrationSeparator的实际值，确认是不是你配置的V_和__。如果显示的是默认值V和__，说明你的配置没被加载。
• 或者用调试日志查看：mvn flyway:info -X，在日志里搜索sqlMigrationPrefix，看看Flyway实际使用的参数是什么。

如果配置没生效，检查这些点：

• 插件配置是否放在<build><plugins>节点下，而不是<pluginManagement><plugins>（后者只是声明配置，不会自动生效，需要在<plugins>里再引用插件）。
• 如果配置在Maven Profile里，确认运行命令时激活了对应的Profile（比如加-Pyour-profile-name）。
• 检查pom.xml里的<properties>是否有同名属性（比如flyway.sqlMigrationPrefix）覆盖了插件配置。

2. 仔细核对文件名的正确性 #

虽然你说文件名是V_1__create_new_table.sql，但还是要确认：

• 文件系统里的实际文件名没有拼写错误，比如是不是把下划线写成了点（变成V.1__create_new_table.sql），或者有隐藏空格、特殊字符。
• 文件名大小写是否和配置匹配：Flyway 4.x对大小写敏感，配置的前缀是V_，文件名必须以V_开头，不能是小写的v_。

3. 尝试简化配置，排查自定义规则的问题 #

暂时去掉自定义的前缀和分隔符，用Flyway默认规则测试：

• 把插件配置里的<sqlMigrationPrefix>和<sqlMigrationSeparator>删掉，使用默认值（前缀V，分隔符__）。
• 把文件名改成V1__create_new_table.sql，然后运行mvn flyway:migrate。如果能正常执行，说明自定义前缀/分隔符的配置有问题，再回头检查配置的拼写和加载情况。

4. 考虑升级Flyway版本 #

你用的Flyway 4.0.3是2016年的老旧版本，可能存在一些已知的配置解析bug。尝试升级到较新的稳定版本（比如5.x系列，或者更高的兼容版本），注意升级时可能需要调整少量配置，但基本的迁移规则是向下兼容的。升级后再测试你的自定义配置是否正常工作。

5. 检查是否有外部参数干扰 #

运行Maven命令时，是否传入了系统参数覆盖了配置？比如-Dflyway.sqlMigrationPrefix=V这种参数会优先于pom.xml里的配置。可以通过mvn help:effective-pom查看最终生效的配置，确认没有被外部参数覆盖。

内容的提问来源于stack exchange，提问作者Nick Div