AdonisJS 项目中使用 SWC 编译器的装饰器问题解析

在 AdonisJS 项目中，开发者可能会遇到一个与 SWC 编译器相关的装饰器问题。这个问题主要出现在使用 @inject 等装饰器时，会导致开发服务器崩溃。

问题现象

当开发者将 @swc/core 升级到 1.7.35 版本后，在控制器中使用 @inject() 装饰器时，开发服务器（无论是否启用 HMR）都会抛出 "Invalid or unexpected token" 的错误。这个错误会导致服务器无法正常运行，影响开发体验。

问题根源

经过分析，这个问题源于 SWC 编译器在 1.7.35 版本中对装饰器的处理存在缺陷。当代码中包含 @inject() 这样的装饰器时，SWC 编译器无法正确转换代码，导致生成的输出不符合 JavaScript 语法规范，从而引发运行时错误。

解决方案

目前有两种可行的解决方案：

1. 降级 SWC 版本：将 @swc/core 降级到 1.7.26 或 1.7.28 版本，这些版本可以正确处理装饰器语法。可以通过以下命令进行降级：

   npm install -D @swc/core@1.7.26 --save-exact
   

2. 等待官方修复：SWC 团队已经在后续版本中修复了这个问题，开发者可以关注官方更新，在确认问题解决后升级到最新版本。

最佳实践建议

对于 AdonisJS 项目，建议开发者：

1. 在项目初始化时，明确指定 SWC 的稳定版本
2. 在升级编译器版本前，先在开发环境充分测试
3. 关注官方公告，了解已知问题和修复情况
4. 对于生产环境，确保使用的工具链版本经过充分验证

技术背景

装饰器是 TypeScript 和现代 JavaScript 中的重要特性，AdonisJS 框架广泛使用装饰器来实现依赖注入等功能。SWC 作为高性能的 Rust 编写的编译器，在处理这些高级语法特性时需要特别注意兼容性和正确性。

这个问题提醒我们，在 JavaScript 生态系统中，即使是成熟的工具链也可能存在版本间的兼容性问题。作为开发者，我们需要在追求新版本功能的同时，也要注意稳定性，特别是在生产环境中。