NestJS CLI 构建过程中资源文件复制问题解析

问题背景

在NestJS项目构建过程中，开发人员发现了一个关于资源文件复制的异常行为。当使用Nest CLI进行项目构建时（通过npm run build命令），配置在nest-cli.json中的资源文件并未按预期复制到输出目录中。这个问题的特殊之处在于，只有当watchAssets配置项设置为true时，资源文件才会被正确复制。

问题表现

具体表现为：

1. 在nest-cli.json中配置了资源文件路径和输出目录
2. 执行构建命令后，预期应该被复制的资源文件没有出现在目标目录
3. 只有当watchAssets设置为true时，资源文件才会被正确复制
4. 这种行为在NestJS 9升级到10版本后出现变化

技术分析

这个问题实际上涉及两个不同的bug：

1. 资源文件路径匹配问题：在NestJS 10中，资源文件路径的匹配规则发生了变化。原先使用../someDir/的路径格式现在需要明确使用通配符，如../someDir/*或../someDir/**（当需要包含子目录时）。

2. watchAssets配置影响构建行为：watchAssets本应只影响开发模式下文件监视的行为，但却意外影响了构建过程中的资源复制逻辑，这是不符合设计预期的。

解决方案

NestJS团队在10.4.3和10.4.4版本中分别修复了这两个问题：

1. 首先在10.4.3版本中修复了资源文件路径匹配的问题
2. 随后在10.4.4版本中修复了watchAssets配置影响构建行为的问题

最佳实践建议

基于这个问题的解决过程，建议NestJS开发者：

1. 明确资源文件路径格式，建议使用通配符明确指定要包含的文件
2. 保持Nest CLI工具更新到最新版本
3. 在升级NestJS大版本时，特别注意资源文件处理相关的变更
4. 对于关键资源文件（如SSL证书等），建议在构建后验证其是否被正确复制

总结

这个问题的解决展示了NestJS团队对开发者体验的重视。通过快速响应和修复，确保了构建过程的可靠性和一致性。对于开发者而言，理解工具的行为变化并及时更新依赖是保证项目稳定性的重要因素。