CUBA Platform前端UI执行update-model命令报错ECONNREFUSED问题咨询

触发原因 #

报错核心为ECONNREFUSED（连接被拒绝），本质是前端模型生成工具尝试请求本地CUBA后端服务失败，常见触发场景如下：

• CUBA后端服务未启动，或启动过程中报错退出
• 前端配置的后端服务端口，与后端实际启动端口不一致
• 后端跨域（CORS）配置限制了本地前端地址的访问权限
• 本地防火墙、VPN、代理类软件拦截了对应端口的请求

解决方案 #

按优先级依次排查：

1. 确认后端服务正常运行：打开CUBA Studio启动后端服务，等待控制台输出启动成功提示，确认无报错信息
2. 核对前后端端口配置：打开前端项目根目录下的.env或.env.development配置文件，检查后端地址配置项（React前端为REACT_APP_CUBA_URL，Vue前端为VUE_APP_CUBA_URL），确认端口与后端启动端口完全一致，默认CUBA后端端口为8080，配置示例：REACT_APP_CUBA_URL=http://localhost:8080/app/rest/
3. 校验后端跨域配置：检查后端modules/core/web/WEB-INF/web.xml文件中的CORS配置，确认已放开本地前端的访问地址（通常为http://localhost:3000），默认CUBA配置允许所有来源访问，如手动修改过需补回对应规则
4. 排查本地网络限制：临时关闭防火墙、VPN、代理软件后，重新执行npm run update-model命令
5. 手动验证后端接口可用性：在浏览器地址栏输入配置的后端地址拼接/rest/v2/info，确认能正常返回JSON格式的服务信息后，再执行模型更新命令

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