REST API 设计中几个容易被忽略的细节
从资源命名、状态码、统一响应到错误信息设计，整理一套更适合长期维护的接口约定。
API Design8 min read
Development Notes
把复杂的问题，整理成清晰的经验。
一个专注软件开发与工程实践的个人技术笔记页面。记录后端开发、Linux、网络、数据库、容器与日常排障过程中值得长期保留的思路与方法。
RECENT NOTES
最近整理的笔记
内容为静态展示，不设置跳转
Linux 服务异常时的排查顺序
从进程、端口、日志、资源占用到网络链路，形成一套尽量减少无效尝试的排障路径。
Linux / Ops11 min read
从 DNS 到 HTTPS，一次请求经历了什么
用尽量直观的方式梳理解析、建连、TLS 握手、反向代理与应用响应之间的完整链路。
Network12 min read
KNOWLEDGE MAP
持续关注的技术方向
JavaSpring BootREST APIMySQLRedisLinuxCaddyNginxDockerTCP / UDPDNSHTTPS / TLSS3 StorageShellGitObservabilityCachingSQL Tuning
FOCUS
不是追逐所有新技术，而是把常用能力理解得更扎实。
关注真正影响稳定性、可维护性和开发效率的基础能力，并通过实际问题把知识连接起来。
RECENTLY UPDATED
近期更新主题
统一异常处理
整理业务异常、参数校验与未知异常的分层处理方式。
慢 SQL 分析
从执行计划到索引设计，记录几个常见性能问题的判断方式。
连接问题定位
区分 DNS、路由、端口、TLS 与应用层异常，缩短定位链路。
服务部署整理
记录反向代理、日志、健康检查与服务重启的常用配置思路。
WRITING PRINCIPLES
笔记整理原则
01
先讲问题，再讲方案
记录上下文、现象与约束，让结论能够被理解，而不是只留下命令和答案。
02
优先保留可复用经验
比起一次性解决方案，更关注以后遇到类似问题时仍然有效的判断方法。
03
保持简单与可验证
尽量减少不必要的复杂度，用清晰步骤和可验证结果确认每个判断。