SQLDelight 项目中如何优化运行时依赖以减小JAR包体积

SQLDelight 是一个优秀的 Kotlin 多平台数据库库，它通过编译时代码生成的方式提供类型安全的 SQL 查询。但在实际使用中，开发者可能会遇到运行时依赖导致 JAR 包体积过大的问题。

问题背景

在 SQLDelight 项目中，特别是使用 PostgreSQL 方言(dialect)时，构建工具会引入 kotlin-reflect 作为传递依赖。kotlin-reflect 是一个较大的库，会增加约 20% 的 JAR 包体积。这对于对包大小敏感的场景(如 Serverless 函数)来说影响较大。

依赖关系分析

通过依赖分析工具可以看到，SQLDelight 的 PostgreSQL 方言模块(app.cash.sqldelight:postgresql-dialect)会通过 KotlinPoet 间接引入 kotlin-reflect 依赖。KotlinPoet 是一个用于生成 Kotlin 代码的库，它在某些情况下需要使用反射功能。

解决方案

实际上，这里存在一个常见的配置误区。SQLDelight 的方言模块(dialect)是用于代码生成阶段的编译时依赖，不应该作为运行时依赖包含在最终应用中。正确的做法是：

1. 在 Gradle 配置中，将方言依赖声明为 ksp 或 kapt 依赖(取决于使用的注解处理器)
2. 运行时只需要包含 SQLDelight 的核心运行时库和对应的 JDBC 驱动

如果确实需要临时解决这个问题，可以通过 Gradle 的 exclude 功能显式排除反射依赖：

implementation(libs.sqldelight.postgres.dialect) {
    exclude(group = "org.jetbrains.kotlin", module = "kotlin-reflect")
}

最佳实践

对于 SQLDelight 项目的依赖配置，建议遵循以下原则：

1. 严格区分编译时依赖和运行时依赖
2. 方言模块(dialect)只应在编译阶段使用
3. 运行时只需要 JDBC 驱动和 SQLDelight 核心运行时库
4. 对于 Serverless 等对包大小敏感的场景，定期使用依赖分析工具检查不必要的传递依赖

通过正确的依赖配置，可以显著减小最终应用的体积，同时保持 SQLDelight 提供的所有功能。这种优化对于云函数、移动应用等对包大小有严格要求的场景尤为重要。