中间件默认值该保守还是激进？聊聊我们团队踩过的坑

【背景】

做中间件这些年，我越来越觉得：一个组件真正决定口碑的，不是它"能做什么"，而是"什么都不配置时它长什么样"。默认值（default）是用户和你第一次打交道时唯一会碰到的东西——大多数业务方根本不会去翻你的文档，他们 clone 下来、new 一个、跑起来，那一刻你给的所有默认值就是他对你的第一印象。

我最近 review 两个内部组件的默认配置，发现同一个团队里两种思路打架得很凶：

• 一种是"保守派"：超时给 30s、连接池给 10、重试给 3 次、默认全量打日志。理由是不想替用户做危险决策，宁可慢一点、宁可多打日志，出事了用户自己调。
• 一种是"激进派"：超时给 1s、连接池按 CPU 核数算、重试默认 0、日志默认 WARN。理由是默认就该是"生产可用且最优"，保守默认值等于把锅甩给用户。

【几种常见做法】

1. 默认保守 + 文档强调"生产请调整"——省心但容易埋雷，用户不调就直接上线。
2. 默认激进 + 提供"安全模式"开关——性能好，但默认值一旦踩雷影响面大。
3. 按场景分 profile（dev / prod 两套默认）——理论上最"对"，但最复杂，用户得自己选 profile，选错了照样出事。
4. 干脆不预设、强制显式传参——把决策权完全交出去，但用起来最累，新人最容易漏配。

【我的倾向与理由】

我倾向"默认要安全，但安全不等于保守"。打个比方：默认值就像新车出厂时的胎压——它不该是赛道极限值（激进），也不该是"随便开开"的最低值（保守），而应该是"绝大多数路况下既安全又不会爆胎"的区间。具体到组件，我会这样划：

• 涉及正确性 / 一致性的（超时、重试、幂等键）：默认偏保守，宁可慢不可错，因为这类默认值错了就是数据事故，代价远高于多花几十毫秒。
• 涉及吞吐 / 资源的（连接池、线程池、批量大小）：默认给一个"够用但不浪费"的中间值，同时暴露清晰的调参入口，并让"当前生效值"可观测。
• 涉及可观测的（日志级别、trace）：默认 WARN 起步，但保证关键路径的 ERROR 一定带上下文，别让用户"出事了一看日志一片空白"。

【想听大家怎么选】

特别想听听在不同场景下你们怎么划这条线：

• 你的组件是"对内自研"还是"对外开源 / 给别的团队"？默认值策略会不会因此不同？
• 超时 / 重试这类"正确性默认"，你们敢设激进值吗？踩过什么坑？
• 有没有人真用过 dev / prod 两套默认 profile？落地成本高不高、值不值？
• 你们怎么保证"用户没改默认值"这件事本身是可观测的（比如启动时打印一份生效配置快照）？

欢迎带上具体组件、具体默认值和踩过的坑来聊，越具体越好。