KMM项目JS文件在浏览器运行时报iterator未定义错误如何解决

问题修复步骤 #

• 优先对齐依赖版本：你当前使用的Kotlin 1.5.10和配套库版本存在不兼容问题，Kotlin 1.5.10对应的官方配套库版本为：kotlinx.coroutines 1.5.1、ktor 1.6.1、kotlinx.serialization 1.2.2，将build配置中所有相关库的版本替换为对应匹配版本，避免ABI不兼容导致的底层调用错误。
• 停止手动拼接HTML引入依赖：你当前手动引入的JS文件顺序、路径很容易和编译产物不匹配，直接使用Kotlin Gradle插件自动生成的测试HTML文件，文件路径一般为build/js/packages/[你的项目名]/index.html，该文件的依赖引入逻辑由插件自动生成，不会出现顺序、路径错误。
• 排查业务代码空安全问题：Kotlin JS的空值运行时表现和JVM有差异，如果你在业务代码中对可空集合类型Iterable?未做空判断就直接调用map/mapTo方法，就会触发该报错。你可以给所有调用集合转换方法的变量增加空判断，或者临时加!!强制抛出空指针异常，快速定位到具体为空的集合变量。
• 升级Kotlin稳定版本：1.5.x版本的Kotlin JS目标还存在大量已知底层BUG，你可以将Kotlin版本升级到1.6.21或者1.7.20这类后续长期支持的稳定版，大部分底层兼容性问题会被自动修复。

KMM使用建议 #

• 初期开发优先使用官方推荐的版本组合，不要单独升级某一个依赖，所有kotlinx系列库、ktor的版本必须和你使用的Kotlin版本严格对应，90%的奇奇怪怪的编译、运行错误都来自版本不匹配。
• JS目标优先切换到IR编译器后端，legacy后端已经停止维护，IR后端编译出来的产物体积更小、BUG更少，也适配最新的JS生态工具。
• 不要手动处理JS产物的打包、引入逻辑，Kotlin Gradle插件已经内置了完整的webpack集成，直接运行jsBrowserRunGradle任务就能自动启动本地服务打开测试页面，无需自己编写HTML配置依赖。

KMM前期配置阶段确实踩坑较多，但熬过配置期后，业务逻辑一次编写多端运行的收益非常高，能省去大量重复编码的工作量，无需轻易放弃。

内容的提问来源于stack exchange，提问作者vizsatiz