如何通过Spring内置机制利用Link header实现RestClient分页遍历

你完全不需要手动解析Link header字符串，Spring Web模块提供了内置工具类来规范处理这类场景，避免手动字符串截取的脆弱性。

核心思路 #

Spring的HttpHeaders类内置了getLinks()方法，能够自动解析符合RFC 5988规范的Link header，返回标准化的Link对象列表。每个Link对象包含链接的rel关系（比如next）和对应的URI，直接通过匹配rel就能拿到下一页地址。

代码实现（RestClient版本） #

import org.springframework.http.HttpHeaders
import org.springframework.http.ResponseEntity
import org.springframework.web.client.RestClient

fun traverseAllPages(restClient: RestClient, initialUrl: String) {
    var currentUrl: String? = initialUrl
    while (currentUrl != null) {
        // 发送请求获取响应
        val response = restClient.get()
            .uri(currentUrl)
            .retrieve()
            .toEntity(String::class.java)
        
        // 处理当前页数据（根据实际业务替换逻辑）
        handlePageData(response.body)

        // 用Spring内置方法提取下一页链接
        currentUrl = extractNextPageLink(response.headers)
    }
}

private fun extractNextPageLink(headers: HttpHeaders): String? {
    // 从解析后的Link列表中找到rel为next的链接
    return headers.getLinks()
        .firstOrNull { link -> "next".equals(link.rel, ignoreCase = true) }
        ?.uri
        ?.toString()
}

private fun handlePageData(pageData: String?) {
    // 此处编写处理单页数据的业务逻辑
}

优势说明 #

• 符合标准：严格遵循RFC 5988对Link header的定义，能正确处理各种合法格式（比如不同的分隔符、引号写法）
• 健壮性高：避免手动字符串截取可能出现的边界错误（比如header格式变化导致的解析失败）
• 代码简洁：无需维护复杂的正则或字符串操作，直接调用Spring封装好的API即可

依赖说明 #

确保你的项目依赖中包含Spring Web模块（Spring Boot项目可直接使用spring-boot-starter-web），HttpHeaders和Link类都来自org.springframework.http包。

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