Angular CLI 19.2.0构建时LESS源映射问题解析

问题背景

在Angular CLI 19.2.0版本中，部分开发者遇到了一个与LESS样式预处理相关的构建问题。当项目中启用了源映射(sourcemaps)功能时，构建过程会抛出"undefined is not valid JSON"的错误提示，导致构建失败。这个问题在19.1.x版本中并不存在，属于版本升级后引入的回归性问题。

问题表现

受影响的项目在构建时会显示如下错误信息：

"undefined" is not valid JSON [plugin angular-less]

错误来源于Angular构建系统在处理LESS文件时尝试解析源映射JSON数据，但接收到的却是undefined值。值得注意的是，这个问题在不同项目中的出现频率也不相同，有的项目会出现数十次相同的错误。

临时解决方案

目前已知的临时解决方案是：

1. 在angular.json配置文件中禁用源映射功能
2. 回退到Angular CLI 19.1.x版本

技术分析

这个问题本质上与LESS编译器本身的行为有关。当配置要求生成源映射时，LESS在某些特定条件下未能正确生成源映射数据，而是返回了undefined。Angular构建系统在处理这种情况时没有做好防御性编程，导致JSON解析失败。

从技术实现角度看，错误发生在Angular构建系统的LESS语言处理器中。当调用sourceMapToUrlComment函数时，它尝试对sourceMap变量执行JSON.parse操作，但该变量实际上是undefined。这表明在compileString阶段，LESS编译器没有按预期返回源映射数据。

影响范围

这个问题主要影响：

1. 使用LESS作为样式预处理器的Angular项目
2. 在angular.json中启用了源映射功能的项目
3. 从19.1.x升级到19.2.0版本的项目

值得注意的是，即使在同一个工作区中，不同项目可能表现出不同的行为，有些能正常构建，有些则会出现错误。这与项目具体的LESS文件内容和配置有关。

官方回应与修复进展

Angular开发团队已经确认了这个问题，并表示已经有一个修复方案正在处理中。不过，团队希望能收集更多关于触发条件的详细信息，以便添加更全面的测试用例，防止未来出现类似的回归问题。

给开发者的建议

对于遇到此问题的开发者，建议：

1. 暂时禁用源映射功能作为临时解决方案
2. 关注Angular官方更新，及时获取修复版本
3. 如果可能，提供最小化重现案例帮助团队完善测试
4. 检查项目中是否有特殊的LESS用法或配置，这些可能是触发问题的关键因素

随着前端构建工具链的日益复杂，这类预处理器的集成问题并不罕见。理解问题的根源有助于开发者更好地应对类似情况，并在未来版本升级时做好充分测试。