r2dbc-mysql 已归档2024 平滑迁移指南从 dev.miku 迁移到 io.asyncer【免费下载链接】r2dbc-mysqlR2DBC MySQL Implementation项目地址: https://gitcode.com/gh_mirrors/r2d/r2dbc-mysql如果你正在使用 r2dbc-mysql 开发 Spring WebFlux 或响应式数据访问应用最近打开项目文档时可能发现它被标记为Archived已归档。r2dbc-mysql 是最主流的 R2DBC MySQL 响应式驱动实现由 dev.miku 组织维护多年如今官方已停止维护旧坐标全面转向io.asyncer:r2dbc-mysql。别慌这次迁移并不复杂本指南将用最少的代码改动带你完成从dev.miku到io.asyncer的平滑切换。一、先搞清背景r2dbc-mysql 为什么会归档在原仓库的 README.md 顶部官方用醒目的警告明确写道当前仓库不再维护请切换到io.asyncer:r2dbc-mysql。这属于典型的项目易主式归档原维护者 mirromutth 将项目移交给asyncer-io组织继续维护旧坐标dev.miku:r2dbc-mysql停止发布新版本最终停留在 0.8.x 系列新坐标io.asyncer:r2dbc-mysql以 1.x 版本号延续迭代并兼容更新版本的 R2DBC SPI 与 Reactor。对普通用户来说归档不等于不能用了但继续使用旧坐标意味着长期没有安全更新和 bug 修复因此尽早迁移才是正道。二、新旧坐标对照迁移前必读项目旧坐标已归档新坐标推荐GroupIddev.mikuio.asyncerArtifactIdr2dbc-mysqlr2dbc-mysql最新稳定版本0.8.2.RELEASE1.x以 Maven 仓库为准包名dev.miku.r2dbc.mysqlio.asyncer.r2dbc.mysql驱动名drivermysqlmysql不变可以看到ArtifactId、驱动名、配置项完全不变变的只是 GroupId 和包名前缀。这为迁移奠定了零心智负担的基础。三、Maven 依赖迁移最简单的第一步打开你的pom.xml把依赖坐标从dev.miku换成io.asyncer即可!-- 迁移前 -- dependency groupIddev.miku/groupId artifactIdr2dbc-mysql/artifactId version0.8.2.RELEASE/version /dependency !-- 迁移后 -- dependency groupIdio.asyncer/groupId artifactIdr2dbc-mysql/artifactId version1.0.2/version /dependency具体版本号请以 Maven 中央仓库最新发布为准推荐直接使用最新稳定版。四、Gradle 依赖迁移方法使用 Gradle 的项目同样只需一行改动// 迁移前 implementation dev.miku:r2dbc-mysql:0.8.2.RELEASE // 迁移后 implementation io.asyncer:r2dbc-mysql:1.0.2如果你使用 Kotlin DSLimplementation(io.asyncer:r2dbc-mysql:1.0.2)刷新依赖后代码里凡是import dev.miku.r2dbc.mysql.*的地方都会编译报错这正是下一步要解决的。五、包名迁移dev.miku.r2dbc.mysql 换成 io.asyncer.r2dbc.mysql新驱动将所有类的包名从dev.miku.r2dbc.mysql平移到了io.asyncer.r2dbc.mysql类名、方法签名、枚举值全部保持一致所以这是一次纯文本级的替换// 迁移前 import dev.miku.r2dbc.mysql.MySqlConnectionConfiguration; import dev.miku.r2dbc.mysql.MySqlConnectionFactory; import dev.miku.r2dbc.mysql.constant.SslMode; // 迁移后 import io.asyncer.r2dbc.mysql.MySqlConnectionConfiguration; import io.asyncer.r2dbc.mysql.MySqlConnectionFactory; import io.asyncer.r2dbc.mysql.constant.SslMode;三种替换方式任选其一IDE 全局替换IDEA / Eclipse 中搜索dev.miku.r2dbc.mysql全局替换为io.asyncer.r2dbc.mysql最推荐命令行批量替换在项目根目录执行grep -rl dev.miku.r2dbc.mysql --include*.java | xargs sed -i s/dev\.miku\.r2dbc\.mysql/io.asyncer.r2dbc.mysql/g手动修改涉及文件不多时逐文件替换。替换完成后编译通过即代表 90% 的迁移工作已完成。六、连接配置代码需要改吗核心答案基本不用对于大多数使用场景你的连接代码一行都不用动因为驱动名、URL 协议和配置项完全兼容URL 方式ConnectionFactories.get(r2dbc:mysql://user:pass127.0.0.1:3306/db)原样保留编程式 DiscoveryConnectionFactoryOptions.builder().option(DRIVER, mysql)...原样保留编程式配置MySqlConnectionFactory.from(MySqlConnectionConfiguration.builder()...)也原样保留只是 import 换成了io.asyncer包。核心实现类的位置在新版本中一一对应可参考旧版源码理解其结构MySqlConnectionFactory.java连接工厂入口提供from(configuration)静态方法MySqlConnectionConfiguration.java连接配置构建器支持 host、sslMode、zeroDate、unixSocket 等全部选项MySqlConnectionFactoryProvider.javaR2DBC SPI 服务发现实现驱动名固定为mysql。七、Spring Boot 用户迁移要点如果你通过spring-boot-starter-data-r2dbc使用 r2dbc-mysql迁移同样顺滑将依赖中的坐标替换为io.asyncer:r2dbc-mysqlstarter 本身不用换application.yml中的spring.r2dbc.url、username、password等配置无需任何修改重启应用确认数据库连接池正常建立即可。因为 URL 协议和 driver 名都是mysqlSpring Boot 的自动装配机制会自动识别新驱动无需额外配置。八、迁移验证清单改完怎么确认没问题按以下清单逐项核对可大幅降低踩坑概率✅ Maven / Gradle 依赖已更新为io.asyncer坐标✅ 全项目搜索dev.miku.r2dbc.mysql确认 0 处残留✅mvn compile或gradle build编译通过✅ 启动应用观察连接日志确认使用新版驱动✅ 跑一遍核心 CRUD、事务、批量操作的自测用例✅ 若用到扩展 Codec自定义类型编解码确认Extension相关包名也已更新。九、常见问题 FAQQ1旧版 0.8.2 的代码还能用吗能用但不再获得安全更新。如果业务紧急来不及迁移可短期保留建议尽快排期。Q2MySQL 版本有要求吗新旧驱动都兼容 MySQL 5.5 ~ 8.x 系列支持caching_sha2_password、mysql_native_password等全部认证方式数据库侧无需改动。Q3迁移后连接池配置如 r2dbc-pool要改吗不用r2dbc-pool 基于标准 R2DBC SPI 工作与驱动坐标无关。Q4想查看归档版源码怎么获取可通过镜像仓库git clone https://gitcode.com/gh_mirrors/r2d/r2dbc-mysql查看历史版本或直接参考 CHANGELOG.md 了解 0.8.x 的功能演进。十、写在最后r2dbc-mysql 的这次换壳本质上是一次包名 坐标的平移API 层面几乎零破坏。只要按本文的顺序换依赖 → 换 import → 验证编译 → 回归测试半小时内就能完成整个项目迁移。趁着 2024 新版本还在活跃迭代尽早迁移到io.asyncer:r2dbc-mysql才能持续获得响应式 MySQL 驱动的最新特性与安全修复。【免费下载链接】r2dbc-mysqlR2DBC MySQL Implementation项目地址: https://gitcode.com/gh_mirrors/r2d/r2dbc-mysql创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考