Next-intl 在 Next.js 15.0.3 版本中的国际化路由配置问题解析

问题背景

在使用 next-intl 库为 Next.js 15.0.3 项目配置国际化路由时，开发者遇到了一个常见但容易忽视的问题：当 URL 中的语言代码变更时，页面内容并未随之切换。经过排查，发现问题的根源在于中间件(middleware)的放置位置不符合 Next.js 的规范要求。

核心问题分析

在 Next.js 项目中，中间件文件的放置位置有着严格的规定。当项目使用 src 目录结构时，中间件必须放置在 src 目录下，而不能放在项目根目录。这是 Next.js 框架本身的约定，而非 next-intl 库的限制。

解决方案

要解决这个问题，开发者需要：

1. 将 middleware.ts 文件从项目根目录移动到 src 目录下
2. 确保中间件文件路径符合 Next.js 的约定

技术细节

Next.js 对中间件的位置有以下硬性要求：

• 如果没有使用 src 目录结构，中间件应放在项目根目录
• 如果使用了 src 目录结构，中间件必须放在 src 目录下

这种设计是为了保持项目结构的清晰和一致性。当项目规模增长时，将中间件与其他应用代码一起放在 src 目录下更易于维护。

最佳实践建议

1. 始终遵循 Next.js 官方文档中关于文件位置的约定
2. 在配置国际化路由时，先验证中间件是否正常工作
3. 使用 TypeScript 可以提前发现一些配置问题
4. 定期检查项目结构是否符合框架的最新规范

总结

国际化是现代 Web 应用的重要功能，next-intl 为 Next.js 提供了优秀的国际化支持。但在使用过程中，开发者需要注意框架本身的约定和限制。通过正确放置中间件文件，可以确保国际化路由按预期工作，为用户提供无缝的多语言体验。