CodeBuddy 数据分析任务出现异常时，建议按照四层排查路径逐步定位：一、先确认数据源已准备完毕（如 src/、.log、package.json 等文件或目录存在），且未被 .codebuddyignore 错误排除；二、重启 codebuddy-lsp 进程，并开启自动重启功能；三、检查项目索引状态，必要时删除 .codebuddy/ 目录后重新构建；四、验证 codebuddy.tencentcloudapi.com 的网络连通性，以及当前账号是否已开通“智能分析”权限。
当 CodeBuddy 执行数据分析任务时，例如日志统计、代码度量、依赖关系分析、性能瓶颈定位，如果出现分析结果为空、数值异常、执行超时中断，或提示“上下文不足”等问题，通常需要从数据源接入、分析引擎运行状态、项目索引完整性以及权限与网络环境这四个层面逐项检查。
确认分析任务所依赖的数据源是否就绪
CodeBuddy 的数据分析功能并不是凭空生成结果，它必须建立在可读取、结构清晰且未被忽略的原始数据基础上。如果你刚打开的是一个空目录，或者项目中只有配置文件却没有源码、日志或分析输入文件，那么数据分析自然无法正常执行。
建议先进入当前工作区根目录，在资源管理器中确认是否至少存在以下任意一类内容：【src/ 目录、.log 文件、package.json / pom.xml、trace.json 或 profiler 输出】。如果目录中仅有 README.md、.gitignore 或若干空文件夹，那么应先补充可分析的数据内容，再继续执行 CodeBuddy 数据分析命令。
同时检查 .codebuddyignore 文件是否存在误排除关键路径的情况。例如其中若包含 src/**、logs/*.log 等规则，分析引擎会直接跳过源码目录或日志文件，导致分析结果为空或不完整。此时删除对应规则或将其注释掉即可恢复正常。
重启数据分析语言服务器（LSP）进程
CodeBuddy 在执行日志聚合、调用链分析、代码复杂度评估等任务时，依赖独立运行的语言服务器进程。如果该进程发生崩溃或卡死，IDE 界面可能不会明显报错，但你会看到所有分析按钮点击后一直转圈、无响应，或者瞬间退出。
第一步：在终端中执行 killall -9 codebuddy-lsp（macOS/Linux）或 taskkill /f /im codebuddy-lsp.exe（Windows）强制结束残留的分析进程。
第二步：打开IDE设置 → 搜索 “analysis” → 找到 “CodeBuddy > Analysis: Auto Restart LSP” 选项，确保其为启用状态。这项设置可以在下次 LSP 异常退出后自动拉起服务，减少手动处理次数。
第三步：右键任意源码文件 → 选择 “CodeBuddy: Analyze This File” 发起一次轻量级分析任务。若状态栏右下角出现“Analyzing… 1/3”之类的进度提示，通常说明 LSP 已经成功重启并恢复工作。
检查项目索引是否完成或损坏
方法一：查看IDE右下角状态栏
如果状态栏显示 “Indexing… 78%” 或 “Index failed” 等提示，说明 CodeBuddy 尚未完成项目语义索引的构建。在这种情况下直接执行深度分析，往往会得到不完整结果，或者出现“no symbols found”报错。建议等待索引完成，或点击该提示手动执行“Rebuild Index”进行重建。
方法二：手动清除缓存重建
关闭IDE → 进入工作区根目录 → 删除 .codebuddy/ 子目录（注意不是 .vscode/ 或 .idea/）→ 重新打开IDE。这样可以强制 CodeBuddy 从头扫描整个项目并重新建立索引。虽然耗时会稍长，但通常能解决因增量索引异常导致的字段缺失、符号丢失、调用关系中断等问题。
【删除前请确认你未在 .codebuddy/ 下手动保存过自定义规则配置，该目录内无用户级配置，纯属运行时缓存】
验证分析功能所需的网络与权限
部分 CodeBuddy 数据分析能力，例如第三方依赖漏洞扫描、云服务调用链映射、基于模型的异常模式识别等，需要调用 codebuddy.tencentcloudapi.com 提供的分析 API 才能完成。
在终端中运行：curl -I https://codebuddy.tencentcloudapi.com/v1/analysis/health。如果返回 HTTP/2 200，通常表示服务端连通正常；如果请求长时间卡住，或返回 403、502 等状态码，则多半是网络访问策略限制或 Token 权限不足引起的问题。
可按以下路径进一步排查：进入 IDE 后依次点击“帮助”→“Open Logs Folder”，在日志目录中找到日期最新的 log.zip，解压后打开 main.log，并搜索“analysis”和“403”。如果日志里持续出现大量“Unauthorized for resource /v1/analysis/dependency”记录，通常意味着当前登录账号尚未开通 Coding Plan 中的“智能分析”模块权限，需要前往腾讯云控制台完成对应服务开通。