安全使用浅拷贝需控制覆盖层级，将默认配置定义为冻结常量，用空对象作合并目标，对嵌套对象显式合并，并前置校验与降级逻辑。

在合并默认配置时安全使用浅拷贝，关键不是避免覆盖，而是控制覆盖的层级和范围——只让用户配置覆盖顶层字段，不意外污染嵌套结构。

明确默认配置为不可变常量

把默认值定义成 const 声明的冻结对象或纯字面量，防止被函数内部或其他地方意外修改：

• 用 const DEFAULTS = { timeout: 5000, headers: { 'Content-Type': 'application/json' } }，而不是在函数里反复创建
• 若需更强保护，可用 Object.freeze(DEFAULTS)（注意它只冻结第一层）
• 避免把默认对象直接传给 Object.assign 作目标，否则会被改写

始终用空对象作为合并目标

调用 Object.assign 或展开运算符时，第一个参数必须是新对象，确保原始默认项和用户配置都不被修改：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• ✅ 正确：Object.assign({}, DEFAULTS, userOptions)
• ✅ 正确：{ ...DEFAULTS, ...userOptions }
• ❌ 错误：Object.assign(DEFAULTS, userOptions)（污染默认值）
• ❌ 错误：{ ...userOptions, ...DEFAULTS }（默认值反而覆盖用户配置）

对嵌套对象做显式合并而非依赖浅拷贝

headers、params、retryPolicy 这类嵌套对象，浅拷贝会整块替换，丢失未声明的默认子字段。需要单独处理：

立即学习“Java免费学习笔记（深入）”；

• 简单场景：手动展开嵌套项，如 { ...DEFAULTS, ...userOptions, headers: { ...DEFAULTS.headers, ...userOptions.headers } }
• 中等复杂度：封装一个辅助函数，只对特定键做深层合并（例如仅对 headers 和 meta）
• 避免直接用 JSON.parse(JSON.stringify()) 做深拷贝——它会丢掉函数、undefined、Date 等，且性能差

校验与降级逻辑前置

浅拷贝本身不校验数据类型或结构，容易因用户传入 null、string 或错误格式导致运行时异常：

• 合并前检查 userOptions 是否为对象，非对象则跳过或报错
• 对关键字段（如 timeout）做类型判断，typeof userOptions.timeout === 'number' 才采纳
• 允许用户传 headers: null 表示清空，默认逻辑应识别并返回空对象，而非尝试展开 null