非 setup 函数中调用 inject 会失败,因为 inject 依赖当前组件实例上下文(currentInstance),而该上下文仅在 setup 执行期间有效,执行完毕即清空;onMounted、事件回调等时机 currentInstance 已为 null,无法访问父级 provides。

因为 inject() 依赖当前组件实例的上下文,而这个上下文只在组件初始化阶段(即 setup() 或函数式组件执行时)被 Vue 主动绑定。一旦离开这个生命周期,currentInstance 就是 null,inject 就找不到要查的 provides 对象,自然报错。
为什么非 setup 函数里调用 inject 会失败
Vue 在组件创建时,会把父组件的 provides 对象通过 Object.create() 拷贝一份给当前组件,并挂载到 currentInstance.provides 上。inject 的底层逻辑就是顺着 currentInstance 往上找这个链式 provides。但这个 currentInstance 是临时变量,只在 setup 执行期间有效——执行完就清空,防止内存泄漏或跨组件污染。
所以你在 onMounted 回调、普通方法、定时器、事件处理函数甚至 computed 里直接调用 inject,它已经没“主子”可依了。
在 setup 顶层提前注入是最稳妥的做法
只要确保 inject 调用发生在 setup 的同步执行阶段(不是回调里),就能拿到值。后续所有逻辑都用这个已解构/已响应式的引用即可。
- ✅ 正确写法:在
<script setup>顶层直接调用
import { inject } from 'vue'
// ✅ 这里是 setup 顶层,安全
const count = inject('count')
const apiConfig = inject('apiConfig')
function handleClick() {
console.log(count.value) // 直接用
fetch('/user', { headers: { token: apiConfig.token } })
}
- ❌ 错误写法:在任何异步或嵌套函数里重新调用
inject
onMounted(() => {
const count = inject('count') // ❌ 报错!此时 currentInstance 已为 null
})
需要在非 setup 环境使用?用 runWithContext(Vue 3.3+)
如果你必须在请求拦截器、工具函数、全局事件回调等纯逻辑函数中获取 provide 的值,Vue 3.3 引入了 app.runWithContext —— 它能临时恢复上下文,让 inject 正常工作。
- 前提是你的应用实例(
app)已通过createApp创建,并且在根组件或插件中调用过provide - 不能用于未挂载的组件或脱离 app 生命周期的独立函数
// main.js 中
const app = createApp(App)
app.provide('authToken', 'abc123')
// 在某个工具函数里(比如 axios 请求拦截)
function addAuthHeader(config) {
return app.runWithContext(() => {
const token = inject('authToken')
config.headers.Authorization = `Bearer ${token}`
return config
})
}
不推荐但可行的替代方案
如果无法升级 Vue 版本,或上下文不可控,可考虑以下方式,但需注意副作用和响应性丢失风险:
-
提前导出响应式数据:在
setup里注入后,用ref或readonly包一层,挂到全局对象或导出模块变量(仅限简单配置) -
用 provide/inject + 组合式函数封装:把
inject提前写进自定义 Hook 内部,对外暴露的是已注入的响应式引用,使用者无需接触inject
// composables/useApiConfig.js
import { inject, readonly } from 'vue'
export function useApiConfig() {
const config = inject('apiConfig')
if (!config) throw new Error('apiConfig not provided')
return readonly(config) // 防止外部意外修改
}
然后在任意 setup 中直接用:const config = useApiConfig() —— 逻辑清晰,复用性强,也不违反规则。

















