本地执行npm start无法启动SAP Fiori List Report应用问题排查

可能原因及排查步骤 #

1. 代理配置冲突 #

• 检查系统代理：打开Windows「Internet选项」→「连接」→「局域网设置」，确认新网络下的代理自动配置或手动代理是否与Fiori工具的网络请求冲突，必要时临时关闭代理测试。
• 清理npm代理残留：执行以下命令检查并删除可能存在的全局代理配置：

  npm config get proxy
  npm config get https-proxy
  npm config delete proxy
  npm config delete https-proxy
  

• 检查项目本地代理配置：查看项目根目录的ui5.yaml或.env文件，确认是否有硬编码的代理地址，新网络下无法访问的话需要移除或修改。

2. CORS跨域限制 #

• 打开浏览器开发者工具（F12）→「Network」标签，启动应用后观察是否有OPTIONS请求失败，或「Console」标签出现CORS相关报错。
• 检查ui5.yaml中的中间件配置：确认@sap-ux/ui5-middleware-fe-mockserver或@sap/ux-ui5-tooling是否启用了CORS代理，若新网络下OData服务的跨域规则变化，需调整中间件的CORS参数。

3. 端口占用或防火墙拦截 #

• 查看命令行输出，确认应用监听的端口（如http://localhost:8080），尝试直接访问该地址，若无法打开则检查：
  • 端口占用：执行netstat -ano | findstr :<端口号>，若有其他进程占用，修改启动命令端口，例如：

    npm start -- --port 8081
    

  • 防火墙拦截：临时关闭Windows Defender防火墙或路由器防火墙，测试应用是否能正常加载。

4. 本地缓存与依赖异常 #

• 清理并重建依赖：

  rm -rf node_modules .ui5 dist
  npm cache clean --force
  npm install
  

• 检查manifest.json的OData配置：确认dataSources中的服务URL是否为可正常解析的路径（用户已确认直接访问OData正常，此步骤可快速验证）。

5. Node.js版本兼容性 #

• 当前使用的Node.js v22.12.0为非LTS版本，可能与sap/generator-fiori@1.16.1存在兼容性问题。建议切换至LTS版本（如v20.x）：
  1. 安装nvm（Node版本管理器）
  2. 执行以下命令切换版本：

     nvm install 20
     nvm use 20
     

  3. 重新安装依赖并启动应用。

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