使用 Kotlin 创建 Spring Boot 项目
本教程的第一部分将演示如何在 IntelliJ IDEA 中使用项目向导(Project Wizard)通过 Gradle 创建 Spring Boot 项目。
本教程并不强制要求使用 Gradle 作为构建系统。如果你使用 Maven,也可以按照相同的步骤操作。
开始之前
下载并安装最新版的 IntelliJ IDEA,并使用 Ultimate 订阅。
如果你使用的 IntelliJ IDEA 没有 Ultimate 订阅,或者使用的是其他 IDE,可以使用基于 Web 的项目生成器来生成 Spring Boot 项目。
创建 Spring Boot 项目
在 IntelliJ IDEA 中使用项目向导创建基于 Kotlin 的全新 Spring Boot 项目:
在 IntelliJ IDEA 中,选择 File | New | Project。
在左侧面板的 Generators 部分选择 Spring Boot。
在 New Project 窗口中指定以下字段和选项:
Name:demo
Language:Kotlin
Type:Gradle - Kotlin
此选项用于指定构建系统和 DSL。
Package name:com.example.demo
JDK:Java JDK
本教程使用 Amazon Corretto 版本 23。 如果你尚未安装 JDK,可以从下拉菜单中下载。
Java:17
如果你尚未安装 Java 17,可以从 JDK 下拉菜单中下载。

确保已指定所有字段,然后点击 Next。
选择本教程所需的以下依赖项:
- Web | Spring Web
- SQL | Spring Data JDBC
- SQL | H2 Database

点击 Create 生成并设置项目。
IDE 将生成并打开新项目。下载并导入项目依赖项可能需要一些时间。
完成后,你可以在 Project 视图中查看以下结构:

生成的 Gradle 项目符合 Maven 的标准目录布局:
main/kotlin文件夹下包含属于该应用程序的包和类。- 应用程序的入口点是
DemoApplication.kt文件的main()方法。
探索项目的 Gradle 构建文件
打开 build.gradle.kts 文件:它是 Gradle Kotlin 构建脚本,其中包含应用程序所需的依赖项列表。
该 Gradle 文件对于 Spring Boot 来说是标准配置,但它还包含了必需的 Kotlin 依赖项,包括 kotlin-spring Gradle 插件 – kotlin("plugin.spring")。
以下是完整的脚本以及对各部分和依赖项的说明:
// build.gradle.kts
plugins {
kotlin("jvm") version "2.3.21" // 要使用的 Kotlin 版本
kotlin("plugin.spring") version "2.3.21" // Kotlin Spring 插件
id("org.springframework.boot") version "4.1.1"
id("io.spring.dependency-management") version "1.1.7"
}
group = "com.example"
version = "0.0.1-SNAPSHOT"
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
repositories {
mavenCentral()
}
dependencies {
implementation("org.springframework.boot:spring-boot-h2console")
implementation("org.springframework.boot:spring-boot-starter-data-jdbc")
implementation("org.springframework.boot:spring-boot-starter-webmvc")
implementation("org.jetbrains.kotlin:kotlin-reflect") // Kotlin 反射库,使用 Spring 时必需
implementation("tools.jackson.module:jackson-module-kotlin") // 适用于 Kotlin 的 Jackson 扩展程序,用于处理 JSON
runtimeOnly("com.h2database:h2")
testImplementation("org.springframework.boot:spring-boot-starter-data-jdbc-test")
testImplementation("org.springframework.boot:spring-boot-starter-webmvc-test")
testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}
kotlin {
compilerOptions {
freeCompilerArgs.addAll("-Xjsr305=strict", "-Xannotation-default-target=param-property") // `-Xjsr305=strict` 启用 JSR-305 注解的严格模式
}
}
tasks.withType<Test> {
useJUnitPlatform()
}如你所见,Gradle 构建文件中添加了一些与 Kotlin 相关的构件:
在
plugins块中有两个 Kotlin 构件:kotlin("jvm")插件定义了项目中要使用的 Kotlin 版本。- Kotlin Spring 编译器插件
kotlin("plugin.spring")为 Kotlin 类添加open修饰符,使其与 Spring Framework 功能兼容。
在
dependencies块中列出了几个与 Kotlin 相关的模块:tools.jackson.module:jackson-module-kotlin模块增加了对 Kotlin 类和数据类序列化与反序列化的支持。org.jetbrains.kotlin:kotlin-reflect是 Kotlin 反射库,提供了对反射功能的完整支持。
在依赖项部分之后,你可以看到
kotlin插件配置块。 在此处你可以向编译器添加额外的实参,以启用或禁用各种语言功能。
在 Kotlin Gradle 插件中的编译器选项 中详细了解 Kotlin 编译器选项。
探索生成的 Spring Boot 应用程序
打开 DemoApplication.kt 文件:
// DemoApplication.kt
package com.example.demo
import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
@SpringBootApplication
class DemoApplication
fun main(args: Array<String>) {
runApplication<DemoApplication>(*args)
}声明类 – class DemoApplication
在包声明和导入语句之后,你可以看到第一个类声明 class DemoApplication。
在 Kotlin 中,如果一个类不包含任何成员(属性或函数),你可以完全省略类主体({})。
@SpringBootApplication 注解
@SpringBootApplication 注解是 Spring Boot 应用程序中的便捷注解。 它启用了 Spring Boot 的自动配置 (auto-configuration)、组件扫描 (component scan),并允许在其“应用程序类”上定义额外的配置。
程序入口点 – main()
可变实参 – args: Array<String>
查看 runApplication() 函数的声明,你会发现该函数的形参标记有 vararg 修饰符:vararg args: String。 这意味着你可以向该函数传递可变数量的 String 实参。
扩展运算符 – (*args)
args 是 main() 函数的形参,声明为 String 数组。 由于存在一个字符串数组,而你希望将其内容传递给函数,因此请使用扩展运算符(在数组前加上星号 *)。
创建控制器
应用程序现已准备就绪可以运行,但我们先来更新其逻辑。
在 Spring 应用程序中,控制器用于处理 Web 请求。 在同一个包中,在 DemoApplication.kt 文件同级目录下创建 MessageController.kt 文件,并编写 MessageController 类,如下所示:
// MessageController.kt
package com.example.demo
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RequestParam
import org.springframework.web.bind.annotation.RestController
@RestController
class MessageController {
@GetMapping("/")
fun index(@RequestParam("name") name: String) = "Hello, $name!"
}@RestController 注解
你需要告知 Spring MessageController 是一个 REST 控制器,因此应使用 @RestController 注解对其进行标记。
此注解意味着该类将被组件扫描检测到,因为它与我们的 DemoApplication 类位于同一个包中。
@GetMapping 注解
@GetMapping 用于标记 REST 控制器中实现 HTTP GET 调用对应端点的函数:
@GetMapping("/")
fun index(@RequestParam("name") name: String) = "Hello, $name!"@RequestParam 注解
函数形参 name 标记有 @RequestParam 注解。该注解表明方法形参应绑定到 Web 请求参数。
因此,如果你访问应用程序的根路径并提供名为 "name" 的请求参数(例如 /?name=<your-value>),该参数值将作为调用 index() 函数的实参。
单表达式函数 – index()
由于 index() 函数仅包含一条语句,因此你可以将其声明为单表达式函数。
这意味着可以省略花括号,并且函数体直接在等号 = 之后指定。
函数返回值类型的类型推断
index() 函数没有显式声明返回值类型。编译器会通过查看等号 = 右侧语句的结果来推断返回值类型。
Hello, $name! 表达式的类型为 String,因此该函数的返回值类型也是 String。
字符串模板 – $name
运行应用程序
Spring 应用程序现在可以运行了:
在
DemoApplication.kt文件中,点击main()方法旁装订区域中的绿色 Run 图标:
你也可以在终端中运行
./gradlew bootRun命令。这将在你的计算机上启动本地服务器。
应用程序启动后,打开以下 URL:
texthttp://localhost:8080?name=John你应该会看到打印出的响应 "Hello, John!":

下一步
在本教程的下一部分中,你将了解 Kotlin 数据类以及如何在应用程序中使用它们。
