Micronaut单体应用（Thymeleaf渲染）Cookie设置与获取方法问询

刚好我之前在Micronaut项目里处理过类似的第三方认证后设置Cookie的场景，给你梳理下具体的实现步骤，非常好上手。

核心逻辑：靠Micronaut的HttpResponse API搞定 #

Micronaut本身提供了很简洁的API来操作Cookie，不管你是处理第三方认证回调，还是普通的请求处理，都可以用这套方式来设置Cookie，不用绕弯路。

第一步：先构建你需要的Cookie实例 #

首先你得用io.micronaut.http.cookie.Cookie类来创建Cookie，你可以根据需求设置各种属性，比如过期时间、作用路径、安全属性这些：

import io.micronaut.http.cookie.Cookie;
import java.time.Duration;

// 构建一个认证相关的Cookie
Cookie authCookie = Cookie.of("auth_token", "从第三方拿到的令牌值")
        .maxAge(Duration.ofDays(7)) // 设置7天自动过期
        .path("/") // 让Cookie在全站所有路径下都有效
        .secure(true) // 仅在HTTPS连接下传输，生产环境一定要开
        .httpOnly(true); // 禁止前端JS读取，防止XSS攻击，提升安全性

第二步：在控制器里把Cookie加到响应里，同时返回Thymeleaf视图 #

处理第三方认证的回调逻辑时（比如拿到第三方返回的令牌后），你需要把创建好的Cookie添加到HttpResponse对象里，再返回对应的Thymeleaf视图：

import io.micronaut.http.HttpResponse;
import io.micronaut.views.View;
import jakarta.inject.Singleton;
import java.time.Duration;

@Singleton
public class AuthCallbackController {

    @View("auth-success") // 这里对应你的Thymeleaf模板文件名
    public HttpResponse<?> handleThirdPartyAuth() {
        // 这里写你处理第三方认证的逻辑，比如从回调参数里提取令牌
        String thirdPartyAuthToken = "xxx-xxx-xxx";

        // 创建Cookie
        Cookie authCookie = Cookie.of("auth_token", thirdPartyAuthToken)
                .maxAge(Duration.ofDays(7))
                .path("/")
                .secure(true)
                .httpOnly(true);

        // 返回视图，同时把Cookie塞进响应里
        return HttpResponse.ok()
                .cookie(authCookie)
                .body("success"); // 这里的body可以传视图需要的模型数据
    }
}

第三步：在Thymeleaf里验证Cookie是否生效（可选） #

如果你想在前端模板里确认Cookie有没有设置成功，可以用Thymeleaf的#request对象来获取Cookie：

<div th:if="${#request.getCookies().get('auth_token') != null}">
    认证Cookie已成功设置：<span th:text="${#request.getCookies().get('auth_token').value}"></span>
</div>

几个要注意的点 #

• 安全属性不能忘：生产环境一定要开启httpOnly和secure，这俩是防止Cookie被窃取的关键配置。
• 第三方认证场景适配：如果是用OAuth2这类第三方认证，Micronaut已经帮你处理了大部分流程，你只需要在回调控制器里拿到认证后的令牌，再按上面的方法设置Cookie就行。
• Cookie作用域按需调整：如果不需要全站有效，可以把path改成特定路径，比如/api，这样只有后台接口能拿到这个Cookie。

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