Next-Intl路由系统中重复动态参数的处理问题解析

Next-Intl是一个用于Next.js应用国际化的流行库，它提供了强大的路由和本地化功能。在使用过程中，开发者可能会遇到一个关于动态路由参数的特定问题：当同一个动态参数在路径中出现多次时，系统会错误地要求提供多个参数值。

问题现象

在Next-Intl的路由配置中，当开发者尝试定义如下路径结构时会出现问题：

"/seo/things-to-do/[countrySlug]": {
  en:"/[countrySlug]/things-to-do-[countrySlug]",
  fr:"/[countrySlug]/que-faire-[countrySlug]"
}

当使用getPathname函数生成实际路径时，即使只提供了一个参数值，系统也会报错提示参数不足：

Error: Insufficient params provided for localized pathname.
Template: /[countrySlug]/que-faire-[countrySlug]
Params: {"countrySlug":"france"}

技术背景

在传统的Next.js路由系统中，动态参数（以方括号[]标记的路径段）可以灵活地用于构建URL。Next-Intl在此基础上增加了国际化支持，允许为不同语言定义不同的路径结构。

通常情况下，动态参数在路径中只出现一次，系统能够正确处理参数替换。但当同一个参数在路径中出现多次时（如示例中的[countrySlug]出现了两次），Next-Intl的路由解析器会错误地认为需要两个独立的参数值。

问题根源

这个问题的根本原因在于Next-Intl的路由参数替换逻辑存在缺陷。在生成实际路径时，系统会：

1. 扫描路径模板中的所有动态参数标记
2. 检查提供的参数对象是否包含所有必需的参数
3. 进行参数替换

问题出在第2步，系统没有对重复的参数名进行去重处理，导致它错误地认为需要多个同名参数。

解决方案

Next-Intl的开发团队已经确认这是一个bug，并在内部修复了这个问题。修复方案主要包括：

1. 在参数检查阶段对参数名进行去重处理
2. 确保同一个参数名在路径中多次出现时只需要提供一个参数值
3. 保持参数替换逻辑的一致性

修复后，开发者可以正常使用包含重复动态参数的路径配置，系统将正确识别只需要一个参数值即可完成所有位置的替换。

最佳实践

在使用Next-Intl的路由系统时，建议：

1. 尽量避免在同一个路径中多次使用相同的动态参数，除非确实需要
2. 如果必须使用重复参数，确保参数名完全一致（包括大小写）
3. 在升级到包含修复的版本后，测试所有包含动态参数的路由

这个问题展示了国际化路由系统中一个有趣的边缘情况，也提醒我们在设计路由系统时要考虑各种可能的参数使用场景。