Spring Cloud Function用MultiValueMap在Jetty报错，Tomcat运行正常

1. Servlet容器请求处理逻辑差异：Tomcat环境下（单元测试），Spring MVC的DispatcherServlet会自动将application/x-www-form-urlencoded格式的请求解析为MultiValueMap并传递给函数；而GCP云函数适配器依赖的Jetty容器，会直接将原始的org.eclipse.jetty.server.Request对象传入函数，未经过Spring MVC的表单解析流程，导致强转MultiValueMap时抛出ClassCastException。
2. GCP适配器的请求适配逻辑：spring-cloud-function-adapter-gcp的底层实现直接对接Jetty的原始请求，没有复用Spring MVC的请求解析机制，因此不会自动转换表单数据为MultiValueMap类型。

方法1：修改函数参数类型，手动解析表单数据 #

将函数参数从MultiValueMap改为HttpServletRequest，手动从请求中提取表单参数并转换为MultiValueMap：

import jakarta.servlet.http.HttpServletRequest;
import org.springframework.context.annotation.Bean;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import java.util.Arrays;
import java.util.function.Function;

@Bean
public Function<HttpServletRequest, String> processFormRequest() {
    return request -> {
        // 手动解析表单参数为MultiValueMap
        MultiValueMap<String, String> formData = new LinkedMultiValueMap<>();
        request.getParameterMap().forEach((key, values) -> 
            formData.put(key, Arrays.asList(values))
        );
        
        // 编写业务处理逻辑
        return "Processed form data: " + formData.toString();
    };
}

方法2：添加类型转换器，自动转换请求为MultiValueMap #

自定义一个Converter，让Spring自动将Jetty的请求对象转换为MultiValueMap，函数参数可保留MultiValueMap类型：

import jakarta.servlet.ServletRequest;
import org.springframework.context.annotation.Bean;
import org.springframework.core.convert.converter.Converter;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import java.util.Arrays;
import java.util.stream.Collectors;

@Bean
public Converter<ServletRequest, MultiValueMap<String, String>> requestToMultiValueMapConverter() {
    return request -> {
        return request.getParameterMap().entrySet().stream()
                .collect(Collectors.toMap(
                        entry -> entry.getKey(),
                        entry -> Arrays.asList(entry.getValue()),
                        (oldVal, newVal) -> newVal,
                        LinkedMultiValueMap::new
                ));
    };
}

// 函数参数仍使用MultiValueMap
@Bean
public Function<MultiValueMap<String, String>, String> processForm() {
    return formData -> {
        // 业务处理逻辑
        return "Processed: " + formData.getFirst("username");
    };
}

额外注意事项 #

• 确保请求的Content-Type头明确设置为application/x-www-form-urlencoded，否则无法正确解析表单参数。
• 检查版本兼容性：Spring Boot 3.x需搭配spring-cloud-function-adapter-gcp 4.x系列版本（例如4.1.0），版本不匹配可能引发适配问题。

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