esm.sh项目中关于CommonJS模块兼容性的重要修复

问题背景

esm.sh作为一个流行的JavaScript模块CDN服务，近期在v135到v136版本升级过程中出现了一个值得注意的兼容性问题。该问题主要影响那些内部使用CommonJS/require机制的模块，特别是当用户在URL中使用星号(*)前缀请求包名时。

问题现象

在v135版本中，当请求带有外部依赖的包时，系统会构建一个使用import语句导入所有依赖的包，其中内部依赖要么以类似方式导入，要么被rollup打包到代码中。然而在v136版本中，即使请求的是es2022浏览器平台的模块，部分依赖会以require()调用的形式暴露出来。

这种变化导致了浏览器环境下的兼容性问题，因为浏览器原生不支持require()函数。即使通过requirejs等工具添加支持，这种混合模块类型的环境也可能导致意外行为或重复加载问题。

技术分析

以react-dom@^19/client为例：

• v135版本会正确查找ES模块
• v136版本会尝试使用require()动态加载，导致"Dynamic require of XYZ is not supported"错误

这个问题特别体现在以下场景：

1. 在esm.sh/run的演示环境中
2. 当在客户端导入语句前添加星号(*)时
3. 即使正确配置了import map，仍然会出现require错误

解决方案

项目维护团队已经意识到这个破坏性变更的影响，并在#1043提交中修复了这个问题。修复确保了模块系统的一致性，恢复了v135版本中正确的模块加载行为。

对开发者的建议

对于遇到类似问题的开发者：

1. 检查项目中是否使用了带星号(*)前缀的模块请求
2. 确认esm.sh服务版本是否已更新到包含修复的版本
3. 对于关键生产环境，考虑暂时锁定esm.sh版本以避免意外变更

总结

模块加载系统的兼容性对于现代JavaScript应用至关重要。esm.sh团队快速响应并修复了这个影响CommonJS模块在浏览器环境中使用的问题，展现了他们对开发者体验的重视。开发者在使用这类服务时，应当关注版本变更日志，特别是涉及模块系统核心功能的更新。