常见问题解决

这里按问题发生的位置组织排查入口。先选择最接近的现象，再在具体页面中确认环境、日志和复现条件。

分类	适用现象	入口
环境与依赖	版本不一致、端口占用、环境变量、依赖安装失败	环境问题排查
前端构建	构建失败、资源路径、依赖冲突、类型错误	前端构建问题
后端接口	状态码异常、参数、鉴权、数据库和下游依赖	后端接口排查
Java 运行时	CPU 飙升、线程或进程异常	Java 程序 CPU 排查
Linux 系统	内存不足、交换分区缺失	Ubuntu Swap 配置
开发工具	IDEA 插件下载或安装缓慢	IDEA 插件安装问题

这个目录怎么用

常见问题目录用于记录开发、部署、环境配置中遇到的具体问题。每篇问题记录最好包含：现象、原因、排查过程、解决方案和预防建议。

问题排查通用流程

flowchart TD
    A["发现问题"] --> B["记录现象和报错"]
    B --> C["确认复现条件"]
    C --> D["收集日志和环境信息"]
    D --> E["定位可能原因"]
    E --> F["执行最小改动验证"]
    F --> G{"是否解决"}
    G -- 否 --> E
    G -- 是 --> H["记录解决方案和预防措施"]

记录模板

部分	要写什么
问题现象	报错信息、截图、出现频率
环境信息	系统、版本、依赖、运行方式
排查过程	尝试过哪些命令和结论
解决方案	最终有效的步骤
预防建议	后续如何避免再次出现

记录建议

问题记录要尽量保留原始报错，因为后续搜索和复盘都依赖这些关键词。解决方案可以简洁，但排查过程不要完全省略。