paxzone打开终端习惯性敲下 svn up，再执行 cds watch，结果屏幕刷出一串 error——做过 SAP Fiori + CDS 开发的人，对这个画面应该都不陌生。标题里的 “sap fiori cds up error”，说的就是这种尴尬：项目更新之后，本地 CDS 服务起不来，或者起来之后各种报错。
这篇文章不是什么官方文档翻译，而是一份踩坑记录。我花了差不多三个下午，把一类典型的 “up error” 从现象到根因完整过了一遍，顺手整理了排查顺序、高频根因和本地开发环境的稳定配置。内容围绕 SAP Fiori 开发中最常见的 CDS 启动/更新失败场景展开，适合正在用 CAP 或 ABAP CDS 做 Fiori 应用开发、被本地服务启动问题卡住的同学参考。
1. “cds up error”里的 up 到底是什么：两类最常见的触发场景
1.1 场景A：svn up / git pull 更新代码后，本地CDS服务起不来
团队协作开发 SAP Fiori 应用时，最典型的动作就是早上打开项目，先 svn up 或 git pull 拉一遍同事推送的代码，然后启动本地服务。问题恰恰出在这里——你更新了代码，但你的本地环境没有跟着更新。
同事可能改了 package.json 里的依赖，你本地 node_modules 还是旧的，启动时直接报 “Cannot find module”；同事新增了一个 CDS 模型文件，你本地还是编译缓存；同事改了 .cdsrc.json 里的数据库配置，你本地根本没有对应的 HANA 实例；还有更隐蔽的——同事把某个 entity 的主键定义改了，你的本地 SQLite 表还是旧结构，服务启动时模型编译不报错，但访问数据时一片 404。
这个场景下，很多人拉完代码第一反应是重新启动服务，而不是先更新依赖和检查环境变更。这一步恰恰把真正的问题藏住了。代码本身是新的，本地环境是旧的，两者一旦错位，错误信息就会变得非常难懂。
1.2 场景B：cds watch 热重载过程中服务崩溃
另一种 “up error” 不是发生在启动瞬间，而是发生在 cds watch 热重载期间。CDS 开发服务器监听文件变化，你保存一个 .cds 文件，它自动重新编译并重启服务。如果保存的文件刚好处于半完成状态，或者模型里有临时性语法错误，服务就会卡在 “Rebuilding…” 然后完全退出。
更常见的是内存问题。热门词里有个 “fatal error: ineffective mark-compacts near heap limit allocation failed”，这是 Node 进程内存溢出。CDS 项目规模一大，尤其是引入了大量注解和引用后，默认内存上限不够用，热重载又频繁触发编译，进程直接挂掉。这个时候终端里看到的往往不是 CDS 本身的错误，而是 V8 引擎的底层报错，非常容易误导排查方向。
1.3 先判断自己属于哪种，再决定排查方向
遇到 “up error” 时，我第一件事永远是看终端输出，并且看完整输出，而不是只看最后几行。不同现象对应不同方向：
| 现象 | 大概率方向 |
|---|---|
| 启动命令一执行就报错，服务根本没起来 | 依赖缺失、配置错误、端口占用 |
| 服务起来了，但浏览器访问页面空白/报404 | CDS模型编译问题、metadata生成失败 |
| 服务运行中突然崩溃，终端出现内存类报错 | 热重载触发编译、内存上限不足 |
| 应用能打开，但OData请求返回403/405/502 | 网关联调、CSRF token、沙盒配置问题 |
定位问题类型，比盲目重装依赖、重启电脑重要得多。下面按依赖→配置→语法→连接的顺序，把每一层可能踩的坑拆开讲。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. CDS服务起不来的高发根因：按依赖→配置→语法→连接的顺序逐个排查
2.1 依赖层：node_modules 与 package.json 不一致
SAP CAP 项目里，cds watch 或者 npm start 启动时，Node 会加载项目依赖。拉完代码后第一件事不应该是启动服务，而应该是确认 package.json 有没有变化。如果同事新增了 @sap/cds-odata-v2-adapter-proxy、passport 这类依赖，你本地没有安装，启动时 Node 会在 require 阶段直接抛错。
在 Windows 环境里，npm install 还不是百分百可靠。我遇到过多次 npm install 执行完仍提示模块缺失的情况，原因是网络代理缓存了旧的 npm 包索引。这种时候先试：
bash复制npm install
npm audit fix --force
如果还是不行，就彻底清理重装：
bash复制rm -rf node_modules package-lock.json
npm install
注意，package-lock.json 锁文件也会影响依赖解析。SAP CAP 对依赖版本比较敏感，@sap/cds 主版本升级后，很多语法行为会变化。如果你本地锁文件比同事旧，直接 npm install 可能装出一套不一致的依赖树。有人问过为什么 “svn up”