You need to enable JavaScript to run this app. Vue3使用Inertia.js时分页组件内inertia-link报i.default非函数错误,页面内同组件正常
优惠活动
大模型
产品
解决方案
定价
更多

Vue3使用Inertia.js时分页组件内inertia-link报i.default非函数错误,页面内同组件正常

报错原因

该问题由两个叠加的问题触发:

  • 分页组件未对inertia-link对应的Inertia Link组件做本地注册,完全依赖全局组件的自动解析。当编译器在自定义组件上遇到v-html这类特殊处理指令时,会误将全局组件判定为未注册的本地导入,最终因找不到合法的组件构造函数,抛出i.default is not a function的错误。
  • 代码不符合Vue指令使用规范:v-html是作用于原生HTML元素的指令,直接绑定在自定义组件inertia-link上时,会触发编译器的异常解析逻辑。

主页面中inertia-link可正常运行,是因为主页面的该组件仅通过插槽传入纯文本,未在组件上直接绑定指令,编译器可正常匹配到全局注册的组件。替换为原生a标签可正常运行,是因为原生标签属于Vue内置识别元素,不会走组件解析流程。

解决步骤

1. 分页组件内显式注册Inertia Link组件

不要完全依赖全局注册的自动解析,在分页组件的脚本部分引入Vue3版本Inertia的具名导出Link组件,完成本地注册:

// Vue3版本Inertia的Link为具名导出,请勿使用默认导入写法
import { Link } from '@inertiajs/vue3'

export default {
    components: {
        // 本地注册后,模板中的<inertia-link>标签可被编译器精准识别
        'inertia-link': Link
    },
    props: {
        links: Array,
    },
}

2. 修正v-html的使用位置

禁止将v-html指令直接绑定在自定义组件上,将HTML渲染逻辑转移到组件内部的原生元素上:

<!-- 原错误写法:v-html直接绑定在自定义组件上 -->
<!-- <inertia-link ... v-html="link.label" /> -->

<!-- 修正后写法 -->
<inertia-link 
    v-else 
    class="mr-1 mb-1 px-4 py-3 text-sm leading-4 border rounded hover:bg-white focus:border-indigo-500 focus:text-indigo-500" 
    :class="{ 'bg-white': link.active }" 
    :href="link.url"
>
    <!-- v-html交由原生span元素处理,不会触发组件解析异常 -->
    <span v-html="link.label"></span>
</inertia-link>

内容的提问来源于stack exchange,提问作者Basharmal

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 07:36:07