Ktor框架中Content Negotiation与HTML端点共存问题咨询

你遇到的问题是因为Content Negotiation（配合Jackson）插件会根据请求的Accept头自动选择响应序列化策略。Chrome浏览器发起请求时，Accept头默认包含application/json，插件会优先用Jackson把响应内容转成JSON，哪怕你原本要返回HTML。

完全可以同时使用Content Negotiation插件和返回HTML的端点，只需做以下调整：

1. 显式指定HTML响应的Content-Type #

在返回HTML的端点里，手动设置响应类型为text/html，插件会尊重这个设置，不会触发Jackson序列化：

get("/html") {
    call.respond(
        FreeMarkerContent(
            templatePath = "index.ftl",
            model = mapOf("greeting" to "Hello Ktor"),
            contentType = ContentType.Text.Html
        )
    )
}

如果用普通文本返回HTML，也可以这么写：

get("/plain-html") {
    call.respondText("<h1>Hello</h1>", contentType = ContentType.Text.Html)
}

2. 限制Content Negotiation的生效范围 #

配置插件只处理特定路径（比如API接口）的请求，非API路径的HTML端点不受影响：

install(ContentNegotiation) {
    jackson {
        // 你的Jackson配置，比如启用缩进等
        enable(SerializationFeature.INDENT_OUTPUT)
    }
    // 仅对/api开头的路径应用JSON协商
    register(ContentType.Application.Json) {
        filter { call -> call.request.path().startsWith("/api") }
    }
}

3. 针对单个端点禁用Content Negotiation #

用withoutPlugins跳过当前请求的Content Negotiation插件，直接返回HTML：

get("/html") {
    call.withoutPlugins(ContentNegotiation) {
        call.respond(FreeMarkerContent("index.ftl", mapOf("greeting" to "Hello Ktor")))
    }
}

Content Negotiation和HTML端点完全兼容，问题只是插件的自动协商逻辑默认覆盖了你的响应格式需求，上面三种方法任选其一就能解决问题。

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