Eclipse Scout与Zebra Enterprise Browser的JavaScript命名空间冲突问题

问题背景 #

在Eclipse Scout项目中使用Zebra Enterprise Browser的JavaScript API：

• 最初通过项目内的head.html手动加载所需脚本，运行正常。
• 改为通过EB的config.xml配置自动注入脚本（开启<InjectEBLibraries><JSLibraries value="1"/></InjectEBLibraries>）后，出现报错：

ERROR org.eclipse.scout.rt.ui.html.json.JsonMessageRequestHandler.handleLogRequest(JsonMessageRequestHandler.java:287) - JavaScript exception occurred
Uncaught namespace definition conflict! at http://[ip-address]:[port]/:1

• 重新添加已移除的ebapi.js文件后，错误指向该文件的第一行；仅在应用内部触发错误，登录/登出阶段无异常。

问题根源 #

这个冲突是EB自动注入的API脚本与项目中残留的手动加载脚本重复定义了同一个全局命名空间：

• 开启InjectEBLibraries后，EB会自动向应用注入核心API脚本ebapi.js，该脚本会注册专属的全局命名空间（比如EB）。
• 若项目中仍保留手动引入的ebapi.js（或其加载代码），就会导致同一命名空间被两次定义，触发冲突报错。

解决步骤 #

• 彻底移除手动加载的EB脚本：删除head.html中所有加载ebapi.js的<script>标签，同时删除项目目录中对应的脚本文件，确保没有重复加载的源头。
• 排查自定义代码的命名空间：检查项目内的自定义JS代码，确认是否有使用和EB API一致的全局变量/命名空间（比如EB），如有则修改自定义代码的命名空间避免冲突。
• 清理EB缓存：EB可能缓存了旧的脚本文件，即使移除手动加载的文件，缓存仍会加载旧版本。进入EB的设置界面清除缓存，或重启EB时强制刷新应用。
• 验证config.xml配置：确认InjectEBLibraries配置仅在一处开启，没有重复配置导致多次注入脚本。

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