Preact CLI构建过程中卡在"after chunk asset optimization"问题的分析与解决

问题现象

在使用Preact CLI 3.5.0版本进行项目构建时，部分情况下构建过程会在"after chunk asset optimization"阶段卡住，无法继续执行。这个问题在之前的3.3.4版本中从未出现过，但在升级到3.5.0后开始频繁发生。

问题排查

通过深入分析，发现问题出在ForkTsCheckerWebpackPlugin插件与TypeScript 4.9.x版本的兼容性上。具体表现为：

1. 构建过程会在ForkTsCheckerWebpackPlugin执行时卡住
2. 这个问题在长时间运行的IDE环境中更容易复现
3. 中断后重新构建通常可以顺利完成

根本原因

Preact CLI 3.5.0版本移除了对TypeScript的直接依赖，改为peer dependency。这一变更导致：

1. 项目升级时会自动安装满足peer dependency要求的最新TypeScript版本(4.9.x)
2. ForkTsCheckerWebpackPlugin 4.x版本与TypeScript 4.9.x存在兼容性问题
3. 这种兼容性问题表现为构建过程中的随机卡死

解决方案

经过验证，有以下几种可行的解决方案：

方案一：降级TypeScript版本

将项目中的TypeScript版本降级到4.6.x或更早版本，可以避免与ForkTsCheckerWebpackPlugin的兼容性问题。

方案二：升级ForkTsCheckerWebpackPlugin

将ForkTsCheckerWebpackPlugin升级到6.x版本，并相应调整配置格式：

1. 更新插件配置以适配新版本API
2. 为babel-esm插件禁用类型检查，避免重复触发插件执行

方案三：临时调试配置

对于需要快速定位问题的开发者，可以临时修改webpack配置：

1. 关闭ForkTsCheckerWebpackPlugin的静默模式
2. 增加详细日志输出
3. 监控构建过程中的具体执行情况

最佳实践建议

1. 对于大型生产项目，建议采用方案一的降级方式，风险最小
2. 对于准备长期维护的项目，建议考虑迁移到Preact CLI 4.x或Vite
3. 定期检查项目依赖的兼容性矩阵，避免类似问题

总结

Preact CLI构建过程中的卡死问题通常源于依赖版本间的兼容性问题。通过合理控制依赖版本或升级相关插件，可以有效解决这类构建问题。对于Preact项目，保持依赖版本的稳定性和一致性是确保构建可靠性的关键。