Eclipse安装JBoss Tools后打开.xhtml报App Transport Security连接错误如何解决

Eclipse 2021-09 (4.21.0)及以上版本内置的WebKit渲染引擎默认启用了*App Transport Security(ATS)*安全策略，强制要求所有网络资源请求必须使用HTTPS协议。而低版本JBoss Tools插件的XHTML可视化编辑器在加载内置静态资源、关联标签库资源时，部分资源的引用地址仍为HTTP协议，触发ATS拦截规则导致资源加载失败，抛出对应报错。

方法1：修改Eclipse启动参数禁用ATS检查（推荐，不影响插件功能） #

• 找到Eclipse安装目录下的eclipse.ini配置文件

  Mac系统额外操作：右键Eclipse应用→点击「显示包内容」→进入Contents/Eclipse目录即可找到该文件

• 打开文件后定位到-vmargs行，在其下方新增一行配置：

  -Dcom.apple.security.network.client.allow-http=true
  

• 保存文件后重启Eclipse，即可正常打开XHTML文件

若为Mac Ventura及以上版本，需先在「系统设置→隐私与安全性→完整磁盘访问」中给Eclipse开启权限，避免配置文件修改不生效

方法2：升级JBoss Tools至修复版本 #

该问题已在JBoss Tools 4.21.3.Final及以上版本修复，可直接升级插件解决：

• 打开Eclipse顶部菜单栏→帮助→Eclipse Marketplace
• 搜索「JBoss Tools」，点击升级按钮安装最新稳定版
• 重启Eclipse后即可正常使用XHTML编辑器的全部功能

方法3：切换XHTML默认打开方式为纯文本编辑器（临时规避） #

如果暂不希望修改配置或升级插件，可通过关闭可视化编辑功能规避报错：

• 右键项目内的.xhtml文件→打开方式→其他
• 选择「通用文本编辑器」，勾选「对所有*.xhtml文件使用此设置」
• 点击确认即可正常打开文件，缺点是会丢失JBoss Tools提供的标签自动补全、可视化预览等功能

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