Spring Framework+Kotlin：实现实体转XML文件并下载

刚好我之前做过类似的功能，踩过一些小坑，给你一个能直接跑起来的完整方案，应该能解决你遇到的问题：

1. 先配置依赖（build.gradle.kts） #

首先确保你的项目里引入了Spring Web和Jackson XML的依赖，这是处理XML序列化和Web请求的核心：

plugins {
    id("org.springframework.boot") version "3.2.0"
    id("io.spring.dependency-management") version "1.1.4"
    kotlin("jvm") version "1.9.20"
    kotlin("plugin.spring") version "1.9.20"
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
    // 关键：Jackson XML序列化依赖
    implementation("com.fasterxml.jackson.dataformat:jackson-dataformat-xml")
    implementation("org.jetbrains.kotlin:kotlin-reflect")
}

2. 定义你的实体类（带XML注解） #

这里要注意用Jackson的XML注解来指定XML结构，不然序列化出来的XML可能不符合预期。比如我定义一个User实体：

import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement

@JacksonXmlRootElement(localName = "User") // 指定根节点名称
data class User(
    @JacksonXmlProperty(localName = "UserId") // 指定子节点名称
    val id: Long,
    @JacksonXmlProperty(localName = "UserName")
    val name: String,
    @JacksonXmlProperty(localName = "UserEmail")
    val email: String
)

3. 编写Spring控制器（处理下载请求） #

控制器里要做三件事：生成实体数据、序列化成XML字符串、设置响应头让浏览器触发下载：

import com.fasterxml.jackson.dataformat.xml.XmlMapper
import org.springframework.http.HttpHeaders
import org.springframework.http.MediaType
import org.springframework.http.ResponseEntity
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RestController

@RestController
class XmlDownloadController {

    private val xmlMapper = XmlMapper()

    @GetMapping("/download-xml")
    fun downloadXml(): ResponseEntity<String> {
        // 1. 模拟生成你的现有实体数据（这里替换成你实际的实体对象）
        val user = User(id = 1L, name = "张三", email = "zhangsan@example.com")

        // 2. 将实体序列化为XML字符串
        val xmlContent = xmlMapper.writeValueAsString(user)

        // 3. 设置响应头，让浏览器下载文件
        val headers = HttpHeaders().apply {
            contentDispositionFormData("attachment", "user-info.xml") // 指定下载的文件名
            contentType = MediaType.APPLICATION_XML
        }

        return ResponseEntity.ok()
            .headers(headers)
            .body(xmlContent)
    }
}

4. 前端页面（添加点击按钮） #

写一个简单的HTML页面，放在src/main/resources/static目录下（Spring Boot会自动识别静态资源），点击按钮触发下载请求：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>XML下载示例</title>
</head>
<body>
    <button onclick="downloadXml()">点击生成并下载XML</button>

    <script>
        function downloadXml() {
            // 发起GET请求，浏览器会自动处理下载
            window.location.href = '/download-xml';
        }
    </script>
</body>
</html>

可能的问题排查（针对你之前失败的情况） #

• 依赖缺失：一定要确保引入了jackson-dataformat-xml，这是Jackson处理XML的核心依赖，之前你可能漏了这个？
• 注解错误：如果不用@JacksonXmlRootElement和@JacksonXmlProperty，序列化出来的XML节点名称可能会和实体属性名不一致，甚至结构混乱。
• 响应头设置：必须指定content-disposition: attachment; filename=xxx.xml，否则浏览器可能会直接显示XML内容而不是触发下载。

启动你的Spring Boot项目，访问http://localhost:8080，点击按钮就能下载生成的XML文件了！

内容的提问来源于stack exchange，提问作者stLeu