Spring MVC矩阵变量仅能获取单个参数值问题排查

看起来你遇到的问题是Spring MVC没有正确解析路径段中的所有矩阵变量，只拿到了第一个。咱们一步步来排查和解决：

1. 修正矩阵变量的注解配置 #

先看你的第二个测试方法，你用了@MatrixVariable Map<String, String> vars但没有指定pathVar参数。Spring需要明确知道从哪个路径变量对应的路径段中提取矩阵变量，所以应该修改为：

@GetMapping(value = "/matrix_test_two/{vars}", produces = MediaType.APPLICATION_JSON_VALUE)
public Map<String, String> getMatrixTestTwo (@MatrixVariable(pathVar = "vars") Map<String, String> vars) {
    return vars;
}

这样Spring才会从{vars}这个路径段里提取所有以分号分隔的矩阵变量，而不是只取第一个。

2. 确认配置类是否生效 #

虽然你已经写了WebConfig来启用矩阵变量支持，但要确保这个配置类被Spring容器正确扫描到：

• 检查WebConfig所在的fr.compagny.project.configuration包是否被@ComponentScan覆盖（如果主启动类用了@SpringBootApplication，它默认会扫描当前包及子包，所以要保证配置类在这个范围内）。
• 排查有没有其他WebMvcConfigurer或WebMvcConfigurerAdapter实现类覆盖了你的configurePathMatch配置，如果有，需要调整优先级或者合并配置逻辑。

3. 排查Spring版本的潜在问题 #

Spring 4.3.12.RELEASE确实存在一些矩阵变量解析的小bug，如果你上面的配置都没问题但还是无法解决，可以尝试升级到4.3.x系列的较新版本（比如4.3.30.RELEASE，这是4.3分支的最后一个稳定版），很多这类细节问题在后续版本中被修复了。

4. 验证第一个测试方法的调用逻辑 #

对于第一个方法getMatrixTestOne，当你调用GET /my_awesome_project/matrix_test_one/v1=toto;v2=titi;v3=tata时，理论上Spring应该能正确提取三个矩阵变量。如果还是提示缺失，除了上面的配置问题，还可以检查：

• 你的Servlet容器（比如Tomcat）是否有额外配置去掉了分号后的内容？不过你已经设置了urlPathHelper.setRemoveSemicolonContent(false)，这个应该已经规避了容器层面的问题。
• 有没有请求拦截器或过滤器修改了请求路径？比如某些安全过滤器可能会篡改URL结构，导致矩阵变量丢失。

测试验证 #

修改第二个方法的注解后，重新调用GET /my_awesome_project/matrix_test_two/v1=toto;v2=titi;v3=tata，应该能返回包含所有三个键值对的Map：

{ "v1": "toto", "v2": "titi", "v3": "tata" }

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