FoalTS 5.0.0 发布：现代化 Node.js 框架的重要升级

FoalTS 是一个基于 TypeScript 的 Node.js 框架，专注于提供简洁、高效且类型安全的 Web 开发体验。作为一款全栈框架，FoalTS 集成了路由、ORM、认证、日志等常用功能，同时保持了良好的模块化和可扩展性。最新发布的 5.0.0 版本带来了多项重要改进和突破性变更，标志着框架向现代化开发标准又迈进了一步。

核心升级与突破性变更

运行环境支持调整

FoalTS 5.0.0 放弃了对 Node.js 18 和 20 的支持，新增了对 Node.js 22 的支持。这一变更意味着框架现在完全基于 ES2023 标准进行编译，开发者可以享受到最新的 JavaScript 语言特性。同时，TypeScript 的最低支持版本提升至 5.5，这为类型系统带来了更强大的能力。

类型系统增强

新版本对类型系统进行了显著增强，最明显的变化是 Context.state 的默认类型现在为 {}。这一调整强制开发者显式声明状态类型，避免了隐式的 any 类型使用，从而提高了代码的类型安全性。对于需要访问 ctx.state 的场景，开发者现在必须明确指定状态类型，这虽然增加了少量样板代码，但显著提升了代码的健壮性。

控制器参数处理优化

5.0.0 版本改进了控制器方法的参数处理方式。现在请求对象会作为第二个参数传递给控制器方法，这使得请求体、路径参数和查询参数的类型声明更加直观和集中。这种改进不仅简化了类型声明，还使代码结构更加清晰，减少了类型断言的使用。

日志系统改进

日志系统进行了多项优化：

• Logger.addLogContext 方法现在接受一个记录对象而非键值对，这使得添加多个上下文信息更加方便
• 移除了已弃用的 settings.loggerFormat 配置，改用更明确的 settings.logger.logHttpRequests 配置
• 脚本执行的日志记录得到了增强，现在会自动添加脚本名称和ID到日志上下文，并在脚本结束时记录执行结果

脚本执行增强

Shell 脚本的 main 函数现在接收 ServiceManager 实例和 Logger 作为参数，这为标准化的依赖注入和日志记录提供了支持。此外，脚本执行过程中的错误现在会自动由框架记录，简化了错误处理流程。

移除的废弃功能

5.0.0 版本清理了多个已标记为废弃的功能：

• 移除了 @Log 钩子，建议开发者使用 Logger 服务配合自定义 @Hook 实现日志功能
• 移除了 npx foal run-script 命令别名，统一使用 npx foal run
• 移除了 AbstractProvider.redirect 方法，改用更明确的 createHttpResponseWithConsentPageUrl

依赖项更新

框架的核心依赖进行了全面升级：

• TypeORM 升级至 0.3.24 版本
• 移除了 node-fetch 依赖
• 各子包的核心依赖如 AWS SDK、Socket.IO、Swagger UI 等均更新至最新稳定版本

升级建议

对于现有项目升级到 5.0.0 版本，开发者需要注意以下几点：

1. 确保运行环境升级到 Node.js 22
2. 更新 TypeScript 到 5.5 或更高版本
3. 检查并更新所有控制器中 Context.state 的类型声明
4. 替换所有已移除的废弃功能调用
5. 根据新规范调整日志配置和脚本实现

FoalTS 5.0.0 的这些变化虽然带来了一些突破性变更，但总体上使框架更加现代化、类型更安全，同时也为未来的功能扩展奠定了更好的基础。对于新项目，这些改进将提供更优秀的开发体验；对于现有项目，虽然升级需要一定工作量，但获得的好处值得投入。