Oracle SQL脚本中#与$参数的区别及Flyway迁移故障排查

这两种写法本质是不同工具/框架的变量占位符语法，核心差异如下：

• ${schema_name}：通用标准占位符
  这是业界多数构建工具、数据库迁移工具（包括Flyway）和开发框架默认支持的变量替换语法。Flyway会自动识别这种格式的占位符，在执行迁移脚本时，将其替换为配置中指定的schema_name实际值，所以能正常工作。

• #[schema_name]：私有定制占位符
  这是特定工具或项目自定义的变量替换规则，不属于通用SQL或主流迁移工具的标准语法。它能在原有代码中正常运行，说明原项目依赖了某个内部定制的脚本处理工具、小众迁移框架，或是自定义了模板替换逻辑——这些工具会专门识别#[]格式的标记并替换成实际schema名，但Flyway默认不支持这种语法，直接执行时会把#[schema_name]当作无效的数据库标识符，导致迁移失败。

如果要在Flyway中使用#[]格式的占位符，可以通过修改Flyway配置，将placeholderPrefix设为#[，placeholderSuffix设为]，让Flyway适配这种自定义占位符规则。

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