如何在Java Spring Boot REST接口中获取URL查询字符串中的数据

以下方案均针对请求格式为http://www.myservices.com/api/sampleService?dynamicdata的无键查询串场景：

方案1：直接通过HttpServletRequest获取 #

这是最直接、性能最优的方案，不需要Spring做额外参数解析：

• 核心使用HttpServletRequest内置的getQueryString()方法，可直接返回?之后的完整原始内容
• 代码示例：

import jakarta.servlet.http.HttpServletRequest;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class SampleServiceController {

    @GetMapping("/sampleService")
    public String handleDynamicRequest(HttpServletRequest request) {
        String dynamicData = request.getQueryString();
        // 此处添加dynamicData的处理逻辑
        if (dynamicData == null) {
            return "未传入动态数据";
        }
        return "读取到的动态内容：" + dynamicData;
    }
}

• 注意：如果请求未携带?及后续内容，getQueryString()会返回null，需要提前做判空处理避免空指针。

方案2：通过@RequestParam封装Map获取 #

适合后续可能扩展为键值对参数的场景：

• Spring会自动把所有查询参数封装到Map<String,String>中，无值的查询串会被当做key存储，对应value为空字符串
• 代码示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.Map;

@RestController
@RequestMapping("/api")
public class SampleServiceController {

    @GetMapping("/sampleService")
    public String handleDynamicRequest(@RequestParam Map<String, String> allQueryParams) {
        String dynamicData = allQueryParams.keySet().stream().findFirst().orElse(null);
        // 此处添加dynamicData的处理逻辑
        return "读取到的动态内容：" + dynamicData;
    }
}

方案3：使用UriComponents工具类解析 #

适合在拦截器、过滤器等非Controller层需要解析查询串的场景：

• 用Spring自带的UriComponentsBuilder工具类解析完整请求URI，直接获取查询串
• 代码示例：

import jakarta.servlet.http.HttpServletRequest;
import org.springframework.web.util.UriComponents;
import org.springframework.web.util.UriComponentsBuilder;

public class QueryParser {
    public String parseDynamicData(HttpServletRequest request) {
        StringBuilder fullUri = new StringBuilder(request.getRequestURL());
        if (request.getQueryString() != null) {
            fullUri.append("?").append(request.getQueryString());
        }
        UriComponents uriComponents = UriComponentsBuilder.fromUriString(fullUri.toString()).build();
        return uriComponents.getQuery();
    }
}

内容的提问来源于stack exchange，提问作者Butchi Reddy Velagala