IDEA 启动读不到环境变量:从报错定位到运行配置修复
终端能读取环境变量,IDEA 启动的 Spring Boot 应用却提示未配置。以 skills 目录变量为例,说明如何定位进程环境差异、配置运行参数并验证修复。
DOCUMENTATION / 开发文档
从工程架构、接口集成到问题排查,查阅项目中的实现说明与实践记录。
终端能读取环境变量,IDEA 启动的 Spring Boot 应用却提示未配置。以 skills 目录变量为例,说明如何定位进程环境差异、配置运行参数并验证修复。
从天气穿衣建议示例出发,沿 Spring AI 2.1.0-M1 源码解释 ChatClient 自动配置、@Tool 参数 Schema、ToolCallingAdvisor 多轮循环、反射执行、日志顺序与异常处理,并说明当前气温与全天建议的能力差别。
命令行 mvn clean install 编译通过,IntelliJ IDEA 里却代码飘红、找不到类。根因是 IDEA 与命令行各持一套 Maven 配置、本地仓库与索引缓存。本文给出配置对齐、依赖版本、索引缓存、模块导入、手工模型冲突五类根因与可直接照做的菜单操作。
记录 Thymeleaf 视图解析「找不到资源」报错的根因:Controller 视图名带前导斜杠时,spring.thymeleaf.prefix 一旦多出尾斜杠就会拼出双斜杠路径;给出正确配置与踩坑清单。
讲清 springdoc-openapi 的 webmvc-ui 与 webflux-ui 两组 starter 的本质区别、阻塞 Servlet 与非阻塞 Netty 的技术栈差异、互斥的自动装配条件,以及依赖选择、配置项与分组隔离的正确做法。
梳理 Spring Boot 默认的 URL 查找流程与处理器优先级,分类说明静态资源的存放位置与访问方式,并用表格对比;强调按默认优先级使用、不强行修改以保障安全。
Sparrow 平台的 Maven 架构设计:以 sparrow-parent 统一稳定构建基线,以 sparrow-bom 交付组件版本组合,说明 parent、import 与多模块业务项目的最佳实践。
记录 Sparrow File 接入 springdoc-openapi 时遇到的两个问题、根因与最终方案,并给出「多 starter 共存」场景下给接口文档分组的通用做法。
从一段真实的 Netty 报错出发,定位自定义 handler 继承 ChannelInboundHandlerAdapter 后既不 release 也不 fireChannelRead,导致入站 ByteBuf 引用计数不归零、缓冲持续泄漏直至 OOM,并连带吞掉心跳、拖垮 IM 消息;含代码对比、泄漏链推导与三种修复方案。
结合 WebSocketFrameHandler 案例,梳理 Netty 的引用计数模型、框架自动释放点与手动释放,对比 retainedDuplicate 零拷贝共享与 newFrame 深拷贝,并定位一处「分配后未写入也未释放」导致的直接内存泄漏。
依赖 jar 时找不到源代码,class 文件与源文件代码行对不齐,导致 debug 断点误判的根因与解决方案:补齐 -sources.jar、保证源码与字节码同一次构建。
零基础也能上手的 Java 学习路线:以官方文档与手写代码为锚点,循序渐进掌握语法、面向对象、集合与并发,最终靠项目实战把知识变成能力。