Spring Boot 2.x 與 Kotlin 聯合開發實戰：從環境搭建到 REST API 完整指南

背景：Spring 官方全面擁抱 Kotlin

Spring Framework 5.0 正式支持 Kotlin，Spring Boot 2.x 提供一流 Kotlin 整合體驗。Pivotal 團隊長期擁抱 JVM 多語言（Groovy、Scala），Kotlin 以空安全、協程、與 Java 100% 互操作成為首選。

環境搭建

IDE 支持

• IntelliJ IDEA：原生最佳支持（JetBrains 親生）
• Eclipse：需安裝 Kotlin Plugin

Maven 核心配置

<properties>
    <kotlin.version>1.1.2</kotlin.version>
    <java.version>1.8</java.version>
</properties>

<dependencies>
    <!-- Kotlin 標準庫 (JDK 8 版) -->
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-stdlib-jre8</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
    <!-- 反射支持 (Spring 需要) -->
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-reflect</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
    <!-- Jackson Kotlin 模塊 (序列化支持) -->
    <dependency>
        <groupId>com.fasterxml.jackson.module</groupId>
        <artifactId>jackson-module-kotlin</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
</dependencies>

<!-- 源碼目錄配置 -->
<sourceDirectory>${project.basedir}/src/main/kotlin</sourceDirectory>
<testSourceDirectory>${project.basedir}/src/test/kotlin</testSourceDirectory>

<!-- Kotlin 編譯插件 -->
<plugin>
    <artifactId>kotlin-maven-plugin</artifactId>
    <groupId>org.jetbrains.kotlin</groupId>
    <version>${kotlin.version}</version>
    <configuration>
        <compilerPlugins>
            <plugin>spring</plugin> <!-- 開啟 Spring 插件：自動打開 final 類/方法 -->
        </compilerPlugins>
        <jvmTarget>1.8</jvmTarget>
    </configuration>
    <executions>
        <execution>
            <id>compile</id>
            <phase>compile</phase>
            <goals><goal>compile</goal></goals>
        </execution>
        <execution>
            <id>test-compile</id>
            <phase>test-compile</phase>
            <goals><goal>test-compile</goal></goals>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-allopen</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>
</plugin>

Kotlin Spring Boot 應用啟動類

@SpringBootApplication
class KotlinDemoApplication

fun main(args: Array<String>) {
    SpringApplication.run(KotlinDemoApplication::class.java, *args)
}

Kotlin 語法亮點：

• 類默認 `public`、默認 `final`（需 `open` 或 `spring` 插件自動打開）
• 無屬性/方法的類可省略大括號
• 頂層函數自動 `static`，無需 `static` 關鍵字
• 無返回值函數無需 `Unit` 類型聲明
• `::class.java` 等價 Java `KotlinDemoApplication.class`

構建 REST Controller

@RestController
class HelloController(val helloService: HelloService) { // 主構造函數注入，無需 @Autowired

    @GetMapping("/hello")
    fun helloKotlin(): String = "hello world"

    @GetMapping("/hello-service")
    fun helloKotlinService(): String = helloService.getHello()

    @GetMapping("/hello-dto")
    fun helloDto(): HelloDto = HelloDto("Hello from the dto")
}

關鍵點：

• 主構造函數參數自動成為屬性（`val` = final、`var` = 可變）
• 構造函數注入無需 `@Autowired`（單構造函數類 Spring 自動識別）
• Service 單例用 `val` 防止意外修改

Service 與數據類

@Service
class HelloService {
    fun getHello(): String = "hello service"
}

data class HelloDto(val greeting: String) // 一行實現：equals/hashCode/toString/copy

data class 自動生成：`equals()`、`hashCode()`、`toString()`、`copy()`、`componentN()`，極大減少樣板代碼。

單元測試：Kotlin 空安全實戰

@RunWith(SpringRunner::class)
@SpringBootTest(classes = [KotlinDemoApplication::class], webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class KotlinDemoApplicationTests {

    @Autowired
    lateinit var testRestTemplate: TestRestTemplate // lateinit 非空斷言，延遲初始化

    @Test
    fun `whenCalled_shouldReturnHello`() {
        val result = testRestTemplate.getForEntity("/hello", String::class.java)
        assertNotNull(result)
        assertEquals(HttpStatus.OK, result?.statusCode) // ?. 安全調用
        assertEquals("hello world", result?.body)
    }

    @Test
    fun `whenCalled_shouldReturnHelloService`() {
        val result = testRestTemplate.getForEntity("/hello-service", String::class.java)
        assertEquals("hello service", result?.body)
    }

    @Test
    fun `whenCalled_shouldReturnJSON`() {
        val result = testRestTemplate.getForEntity("/hello-dto", HelloDto::class.java)
        assertEquals(HelloDto("Hello from the dto"), result?.body) // data class 結構化比較
    }
}

空安全機制**：

• 可空類型必須聲明 `?`（如 `TestRestTemplate?`）
• 安全調用操作符 `?.`：鏈路任一環為 null 則返回 null
• `lateinit var`：非空斷言，運行時未初始化拋異常
• 編譯器強制處理 null，從源頭消除 NPE

Kotlin 核心優勢總結

生態現狀與建議

• **Google** 宣布 Android 開發 Kotlin First
• **Spring** 官方文檔提供 Kotlin 並行示例
• **Gradle** Kotlin DSL 成為構建腳本首選
• 新項目**強烈建議**直接使用 Kotlin；存量 Java 項目可漸進式引入（新模塊用 Kotlin）