# shareStrategy
- 类型:`'version-first' | 'loaded-first'`
- 是否必填:否
- 默认值:`'version-first'` (由 webpack 插件/构建时运行时设置)
控制共享依赖的加载策略:
- `'version-first'`:版本优先,确保使用最高版本的共享依赖。设置后,**会在应用初始化时自动加载所有 _remotes_ 入口文件**,并注册对应的共享依赖,确保能获取到所有的共享依赖版本。当对版本有严格要求时,推荐使用此策略。
- `'loaded-first'`:复用优先,大幅减少多余的依赖请求。设置后,不会自动加载 _remotes_ 入口文件(仅在有需求时才会加载),优先复用已加载的共享依赖。当对版本没有严格要求且对性能有要求时,推荐使用此策略。
:::warning 离线远程模块注意事项
`'version-first'` 策略会在应用启动时自动加载远程入口文件以初始化共享依赖。如果任何远程模块离线或无法访问,会在启动期间触发 `errorLoadRemote` 钩子,生命周期为 `'beforeLoadShare'`。如果没有适当的错误处理,可能导致应用初始化失败。
`'loaded-first'` 策略将远程模块加载推迟到实际请求模块时,这意味着离线的远程模块只会在访问特定远程模块时导致失败,而不会在应用启动时失败。
**version-first 遇到离线远程模块时的处理流程:**
1. 初始化期间,通过 `initializeSharing()` 加载远程模块
2. 如果远程清单/入口文件离线,`module.getEntry()` 失败
3. 触发 `errorLoadRemote` 钩子,生命周期为 `'beforeLoadShare'`
4. 如果未提供回退方案,初始化可能挂起或失败
**version-first 所需的错误处理:**
```ts
const plugin = {
name: 'offline-resilient-plugin',
errorLoadRemote(args) {
if (args.lifecycle === 'beforeLoadShare') {
// 处理启动时 version-first 离线远程模块
return {
init: () => Promise.resolve(),
get: (module) => () => Promise.resolve(() => '离线回退组件')
};
}
}
};
```
对于可能存在网络问题的生产应用,建议:
- 使用 `'loaded-first'` 策略以获得更好的弹性
- 为 `'beforeLoadShare'` 生命周期实现全面的错误处理
- 通过插件实现重试机制
- 使用适当的错误边界和回退组件
参见[错误加载远程解决方案](/zh/blog/error-load-remote.md)获取详细的离线处理策略。
:::