笔记列表-低调大师优秀个人博客

文章列表

共 228319 篇

2026-10-27

Python asyncio 中 run_in_executor 的线程池阻塞问题与规避

在把同步阻塞调用（比如 requests、PIL 图像处理、数据库驱动查询）塞进 asyncio 事件循环时，loop.run_in_executor 几乎是条件反射的选择。它看起来简单：把函数扔进线程池，用 await 等结果，事件循环不会被卡住。但真实项目里经常出现一种情况&mdash;&mdash;线上服务跑一段时间后，所有异步请求突然集体变慢，QPS...

阅读约42分钟

2026-10-27

Node.js 中处理 CPU 密集型任务的三种实践：从阻塞事件循环到 worker_threads

在 Node.js 服务里跑图像处理、加解密、PDF 生成或者大 JSON 解析时，事件循环被长时间占住，接口响应会突然从几十毫秒涨到几秒，健康检查超时、WebSocket 心跳丢失、定时任务堆积这些问题会同时冒出来。根本原因是 JavaScript 执行在主线程上，任何同步计算都会阻塞事件循环，而 Node.js 的异步 I/O 优势在 CPU 密集场景下...

阅读约41分钟

2026-10-27

TypeScript 中对象字面量的 excess property 检查，为什么你传了额外的字段就报错

在 TypeScript 里给函数传对象字面量时，经常遇到 Object literal may only specify known properties 这个报错。比如定义了一个 Options 接口只有 url 和 method 两个字段，调用时顺手多写了个 timeout，编译器立刻拒绝。这个行为叫 excess property checking，...

阅读约38分钟

2026-10-27

HarnessRouter 拆解：用一个 API 驱动 30 种 Agent Harness

在产品里放一个能干活的 agent，绕不开一个很具体的麻烦。Codex、Claude Code、Hermes、OpenCode 这些 harness 已经把活干得不错，可它们被驱动的方式各不相同：怎么发起一个任务、怎么跟着看进度、怎么接着上一轮说、怎么中途叫停、怎么把它写出来的文件取回来、怎么弄清它为什么失败。这套动作每接一个 harness，就要重写一遍。...

阅读约29分钟

2026-10-27

Go 语言中 time.Timer 重置与 Stop 的常见陷阱：从一次 goroutine 泄漏排查说起

在一个长连接推送服务里，每个连接都挂了一个 time.Timer 用来做空闲超时检测。逻辑很直白：每次收到客户端消息就重置定时器，如果超过 30 秒没有新消息就断开连接。上线后内存和 goroutine 数缓慢上涨，pprof 显示大量 goroutine 阻塞在 runtime.gopark，最终定位到 Timer 的重置写法有问题。很多人在使用 time...

阅读约32分钟

2026-10-27

Node.js 中 async/await 与流式响应结合时的一个隐蔽陷阱

在 Node.js 里用 Express 或 Koa 写流式接口时，很多人会自然地写出 async (req, res) =&gt; { ... for await (const chunk of stream) { res.write(chunk) } } 这样的代码。表面上看没问题，但实际在客户端断开连接、或者上游数据源是一个慢速的异步迭代器时，会出现资...

阅读约41分钟

2026-10-27

React 中 useEffect 清理函数的一个隐蔽陷阱：异步请求导致的竞态与内存泄漏

在 React 函数组件中，useEffect 的清理函数常被用来取消订阅或清除定时器，但很多人忽略了异步请求场景下的竞态问题。比如一个搜索框组件，每次输入都会触发 useEffect 发起 fetch 请求，用户快速输入时多个请求并发返回，后发请求的结果可能先到，导致界面显示旧数据。更隐蔽的是，组件卸载后请求才返回，此时 setState 会触发 Reac...

阅读约36分钟

2026-10-27

Node.js 中正确使用 worker_threads 处理 CPU 密集型任务

Node.js 的单线程事件循环让它在 I/O 密集型场景下表现优异，但一旦遇到大数组排序、图像处理、加解密或复杂计算，主线程就会被长时间占用，HTTP 请求全部排队，表现为接口响应突然从几十毫秒涨到几秒。很多开发者第一反应是开 child_process 或 cluster，但进程间内存隔离、启动开销和序列化成本在频繁小任务面前并不划算。worker_th...

阅读约39分钟

2026-10-27

Node.js 中 Promise 未捕获拒绝导致进程退出：从 UnhandledPromiseRejection 到优雅处理

在 Node.js 里写异步代码时，一个没有被 catch 的 Promise 拒绝默认会让进程直接退出，这个行为从 Node 15 开始成为默认策略。很多从回调风格迁移过来的项目，或者用 async 函数调用了某个可能抛错的库方法却忘了包裹 try/catch，都会在某个边界条件下突然遇到进程崩溃。日志里通常只留下一行 UnhandledPromiseRe...

阅读约39分钟

2026-10-27

React 中 useEffect 依赖数组的陷阱：为什么你的回调总是拿到旧值

在 React 函数组件里用 useEffect 处理副作用时，依赖数组写错导致回调闭包捕获旧 state 是高频问题。典型场景是定时器、事件监听或异步请求中读取的 state 始终停留在首次渲染的值，组件卸载后 setState 又触发警告。根源在于每次渲染都会生成新的闭包，而依赖数组决定了 effect 是否重新执行。如果漏写依赖，effect 内引用的...

阅读约39分钟

2026-10-27

Node.js 中 require 和 import 混用导致的循环依赖问题排查

在一个维护中的 Express 项目里，最近加了一个新的业务模块，启动时偶尔报 TypeError: Cannot read properties of undefined，刷新页面有时正常有时挂掉。看堆栈指向一个工具函数文件，但单独跑这个文件没问题。这个项目历史比较久，代码里有些文件用 require 加载依赖，有些新写的文件用 import，tsconf...

阅读约41分钟

2026-10-27

浏览器返回按钮导致页面状态错乱？用 pageshow 事件正确处理 bfcache 恢复

在移动端和桌面端浏览器中，用户点击返回按钮时页面经常不会重新加载，而是直接从 bfcache（往返缓存）中恢复。这个机制让导航变得很快，但也带来了一个隐蔽的问题：页面从缓存恢复时，DOMContentLoaded 和 load 事件不会再触发，而 pageshow 事件却会触发，且 event.persisted 为 true。如果代码里把初始化逻辑只挂在 ...

阅读约40分钟

2026-10-27

Node.js 中处理 CPU 密集型任务的正确姿势：从 event loop 阻塞到 worker_threads 实战

在 Node.js 服务里做图片压缩、PDF 解析或者数据加密时，经常会遇到一个尴尬现象：明明接口逻辑不复杂，但并发一上来整个服务就像卡住一样，连健康检查都超时。这通常不是数据库或网络的问题，而是 CPU 密集型任务把 event loop 堵死了。Node.js 的单线程模型让所有 JavaScript 回调都在同一个线程上排队，一旦某个任务同步执行几百毫...

阅读约38分钟

2026-10-27

mica-ppocr 1.2.4 发布：OCR 预处理内存砍半，检测提速 2.6 倍

&amp;gt; 发布日期： 2026-10-25 &amp;middot; 上一版本：v1.2.3（2026-09-12）这一版把预处理内存砍掉一半、检测提速 2.6 倍，顺手清掉了两类「写了却不生效」「关了却关不掉」的问题：PDF 双通道的配置终于传到了引擎，mica.ai.ppocr.enabled=false 之后应用也能正常启动；海报类版面也有了...

阅读约19分钟

2026-10-27

Node.js 中 req.body 为空？从中间件顺序彻底搞懂 body-parser 的解析时机

在 Node.js + Express 项目里接一个前端 POST 请求时，偶尔会遇到 req.body 是 undefined 或者空对象的情况。前端明明用 Content-Type: application/json 发了数据，路由里打印出来却是 {}。这个问题的根源大多不在 HTTP 协议本身，而是 Express 的中间件执行顺序和 body 解析中...

阅读约32分钟

2026-10-27

Node.js 中 Promise.all 导致数据库连接池耗尽的排查与解决

线上一个使用 Node.js + Express + mysql2 的服务在晚高峰频繁出现超时，日志里偶尔能看到 Error: Too many connections。这个服务有一个批量查询接口，会根据前端传入的一批 ID 列表，并行去数据库查每个 ID 对应的记录，最初为了简单，直接用 Promise.all 把几十个查询同时发出去。本地和测试环境数据量...

阅读约42分钟

2026-10-27

Go 服务内存持续上涨？从 pprof 看清 slice 底层数组的持有问题

线上一个 Go 服务跑几天内存就涨到几个 G，重启后恢复，过几天又上去。这种周期性上涨通常不是内存泄漏那种&quot;永远不释放&quot;，而是某些对象被意外持有，GC 无法回收。常见原因包括全局缓存没有淘汰策略、goroutine 泄漏导致栈和引用链无法释放、slice 截取后仍持有原底层数组、以及 map 删除元素后桶未收缩等。这篇从一次实际的排查过程...

阅读约36分钟

2026-10-27

Node.js 中 process.nextTick 与 setImmediate 的执行顺序陷阱

在 Node.js 里写异步代码时，process.nextTick 和 setImmediate 经常被混用，尤其是在处理 I/O 回调后的逻辑或者拆分同步任务时。很多开发者以为 setImmediate 比 process.nextTick 先执行，因为名字里有&ldquo;Immediate&rdquo;，但实际运行结果往往相反。这个问题的典型场景是：...

阅读约38分钟

2026-10-27

NativeAOT 发布 .NET CLI 实测：启动快 7 倍、内存省 5 倍，但反射序列化会直接崩

Agent 每调一个工具往往就 fork 一个 CLI：调 100 次，就起 100 个进程。这时候 dotnet mytool.dll 那 20 多毫秒的启动时间，会实打实摊到每一次工具调用上。

阅读约16分钟

2026-10-27

依赖的显式化：服务目录的最小可行做法

故障防治系列新篇。前面聊过雪崩防治的舱壁模式、依赖治理的度量&mdash;&mdash;都默认了一个前提：你知道自己依赖谁。这篇补上那个前提：依赖怎么变得可见。多数团队的依赖关系一半在代码里、一半在人的脑子里，出事时才临时拼图。

阅读约4分钟

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

文章列表

Python asyncio 中 run_in_executor 的线程池阻塞问题与规避

Node.js 中处理 CPU 密集型任务的三种实践：从阻塞事件循环到 worker_threads

TypeScript 中对象字面量的 excess property 检查，为什么你传了额外的字段就报错

HarnessRouter 拆解：用一个 API 驱动 30 种 Agent Harness

Go 语言中 time.Timer 重置与 Stop 的常见陷阱：从一次 goroutine 泄漏排查说起

Node.js 中 async/await 与流式响应结合时的一个隐蔽陷阱

React 中 useEffect 清理函数的一个隐蔽陷阱：异步请求导致的竞态与内存泄漏

Node.js 中正确使用 worker_threads 处理 CPU 密集型任务

Node.js 中 Promise 未捕获拒绝导致进程退出：从 UnhandledPromiseRejection 到优雅处理

React 中 useEffect 依赖数组的陷阱：为什么你的回调总是拿到旧值

Node.js 中 require 和 import 混用导致的循环依赖问题排查

浏览器返回按钮导致页面状态错乱？用 pageshow 事件正确处理 bfcache 恢复

Node.js 中处理 CPU 密集型任务的正确姿势：从 event loop 阻塞到 worker_threads 实战

mica-ppocr 1.2.4 发布：OCR 预处理内存砍半，检测提速 2.6 倍

Node.js 中 req.body 为空？从中间件顺序彻底搞懂 body-parser 的解析时机

Node.js 中 Promise.all 导致数据库连接池耗尽的排查与解决

Go 服务内存持续上涨？从 pprof 看清 slice 底层数组的持有问题

Node.js 中 process.nextTick 与 setImmediate 的执行顺序陷阱

NativeAOT 发布 .NET CLI 实测：启动快 7 倍、内存省 5 倍，但反射序列化会直接崩

依赖的显式化：服务目录的最小可行做法

资源下载

Mario

腾讯云软件源

Nacos

Spring

欢迎您来访！