[testtoolkit] 新增MySQL测试容器支持

-  添加IDatabaseMysqlContainer接口
-  扩展TestcontainersProperties支持MySQL配置
-  完善MySQL容器使用文档和注释

Author: TrueNine

testtoolkit/src/main/kotlin/io/github/truenine/composeserver/testtoolkit/properties/TestcontainersProperties.kt

@@ -14,11 +14,13 @@ import org.springframework.boot.context.properties.ConfigurationProperties
  *   testtoolkit:
  *     testcontainers:
  *       postgres:
- *         image: "postgres:17.4-alpine"
+ *         image: "postgres:17-alpine"
+ *       mysql:
+ *         image: "mysql:8.0"
  *       redis:
- *         image: "redis:7.4.2-alpine3.21"
+ *         image: "redis:7-alpine"
  *       minio:
- *         image: "minio/minio:RELEASE.2025-04-22T22-12-26Z"
+ *         image: "minio/minio:RELEASE.2025-07-23T15-54-02Z"
  * ```
  *
  * @author TrueNine
@@ -29,6 +31,9 @@ data class TestcontainersProperties(
   /** PostgreSQL 配置 */
   val postgres: PostgresConfig = PostgresConfig(),
 
+  /** MySQL 配置 */
+  val mysql: MysqlConfig = MysqlConfig(),
+
   /** Redis 配置 */
   val redis: RedisConfig = RedisConfig(),
 
@@ -38,8 +43,8 @@ data class TestcontainersProperties(
 
 /** # PostgreSQL 容器配置 */
 data class PostgresConfig(
-  /** PostgreSQL Docker 镜像 默认使用 postgres:17.4-alpine（当前 LTS 版本） */
-  val image: String = "postgres:17.4-alpine",
+  /** PostgreSQL Docker 镜像 默认使用 postgres:17-alpine（当前 LTS 版本） */
+  val image: String = "postgres:17-alpine",
 
   /** 默认数据库名称 */
   val databaseName: String = "testdb",
@@ -51,16 +56,34 @@ data class PostgresConfig(
   val password: String = "test",
 )
 
+/** # MySQL 容器配置 */
+data class MysqlConfig(
+  /** MySQL Docker 镜像 默认使用 mysql:8.0（当前 LTS 版本） */
+  val image: String = "mysql:8.0",
+
+  /** 默认数据库名称 */
+  val databaseName: String = "testdb",
+
+  /** 默认用户名 */
+  val username: String = "test",
+
+  /** 默认密码 */
+  val password: String = "test",
+
+  /** 默认根密码 */
+  val rootPassword: String = "roottest",
+)
+
 /** # Redis 容器配置 */
 data class RedisConfig(
-  /** Redis Docker 镜像 默认使用 redis:7.4.2-alpine3.21（当前稳定版本） */
-  val image: String = "redis:7.4.2-alpine3.21"
+  /** Redis Docker 镜像 默认使用 redis:7-alpine（当前稳定版本） */
+  val image: String = "redis:7-alpine"
 )
 
 /** # MinIO 容器配置 */
 data class MinioConfig(
   /** MinIO Docker 镜像 默认使用较新的稳定版本 */
-  val image: String = "minio/minio:RELEASE.2025-04-22T22-12-26Z",
+  val image: String = "minio/minio:RELEASE.2025-07-23T15-54-02Z",
 
   /** 默认访问密钥 */
   val accessKey: String = "minioadmin",

testtoolkit/src/main/kotlin/io/github/truenine/composeserver/testtoolkit/testcontainers/IDatabaseMysqlContainer.kt

@@ -0,0 +1,81 @@
+package io.github.truenine.composeserver.testtoolkit.testcontainers
+
+import org.springframework.test.context.DynamicPropertyRegistry
+import org.springframework.test.context.DynamicPropertySource
+import org.testcontainers.containers.MySQLContainer
+import org.testcontainers.junit.jupiter.Testcontainers
+
+/**
+ * # MySQL 数据库测试容器接口
+ *
+ * 该接口提供了MySQL测试容器的标准配置，用于集成测试环境。 通过实现此接口，测试类可以自动获得配置好的MySQL测试数据库实例。
+ *
+ * ## 特性
+ * - 自动配置MySQL测试容器
+ * - 提供标准的数据库连接配置
+ * - 支持Spring Test的动态属性注入
+ *
+ * ## 使用方式
+ *
+ * ```kotlin
+ * @SpringBootTest
+ * class YourTestClass : IDatabaseMysqlContainer {
+ *   // 你的测试代码
+ * }
+ * ```
+ *
+ * @see org.testcontainers.junit.jupiter.Testcontainers
+ * @see org.testcontainers.containers.MySQLContainer
+ * @author TrueNine
+ * @since 2025-07-28
+ */
+@Testcontainers
+interface IDatabaseMysqlContainer {
+  companion object {
+    /**
+     * MySQL 测试容器实例
+     *
+     * 预配置的 MySQL 容器，设置可通过配置自定义：
+     * - 数据库名称: 可配置，默认 testdb
+     * - 用户名: 可配置，默认 test
+     * - 密码: 可配置，默认 test
+     * - 根密码: 可配置，默认 roottest
+     * - 版本: 可配置，默认 mysql:8.0
+     */
+    @JvmStatic
+    val container by lazy {
+      val config = TestcontainersConfigurationHolder.getTestcontainersProperties()
+      MySQLContainer<Nothing>(config.mysql.image).apply {
+        withDatabaseName(config.mysql.databaseName)
+        withUsername(config.mysql.username)
+        withPassword(config.mysql.password)
+        withEnv("MYSQL_ROOT_PASSWORD", config.mysql.rootPassword)
+        addExposedPorts(3306)
+        start()
+      }
+    }
+
+    /**
+     * Spring测试环境动态属性配置
+     *
+     * 自动注入数据库连接相关的配置属性到Spring测试环境中：
+     * - JDBC URL
+     * - 用户名
+     * - 密码
+     * - 数据库驱动类名
+     *
+     * @param registry Spring动态属性注册器
+     */
+    @JvmStatic
+    @DynamicPropertySource
+    fun properties(registry: DynamicPropertyRegistry) {
+      registry.add("spring.datasource.url", container::getJdbcUrl)
+      registry.add("spring.datasource.username", container::getUsername)
+      registry.add("spring.datasource.password", container::getPassword)
+      registry.add("spring.datasource.driver-class-name") { "com.mysql.cj.jdbc.Driver" }
+    }
+  }
+
+  val mysqlContainer: MySQLContainer<*>?
+    get() = container
+}