You need to enable JavaScript to run this app. Laravel中使用jQuery UI日期选择器报datepicker is not a function错误
优惠活动
大模型
产品
解决方案
定价
更多

Laravel中使用jQuery UI日期选择器报datepicker is not a function错误

报错核心原因

你遇到的$(...).datepicker is not a function报错,本质是两个常见的前端资源加载问题触发的,和CDN链接本身的可用性关系不大:

  • 全局jQuery实例被重复覆盖:Laravel默认编译的app.js已经内置了jQuery并绑定到全局$,但你在</body>前又同步引入了一次独立的jQuery 1.12.4脚本。这种重复引入会让最后加载的jQuery实例覆盖全局的$,而jQuery UI是绑定在第一次加载的jQuery实例上的,业务代码执行时拿到的$指向的是没有挂载datepicker方法的第二个jQuery实例,自然会抛出方法不存在的错误。
  • 脚本执行时序错位:head中给app.js加了defer属性,这类脚本会等DOM结构完全解析完成后才按顺序执行,但你在body底部写的业务初始化脚本是同步执行的,很容易出现业务代码先跑、datepicker插件还没完成挂载的时序差。
分步修复操作
  1. 移除重复的jQuery引入
    直接删掉</body>前的两个重复引入的脚本:
    <script src="https://code.jquery.com/jquery-1.12.4.js"></script>
    <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script>
    
    从根源上避免多实例冲突的问题。
  2. 按正确时序配置jQuery UI加载
    把jQuery UI的脚本挪到head区域,和app.js保持一致的defer属性:
    <!-- 保持书写顺序,defer脚本会按照书写顺序依次执行 -->
    <script src="{{ asset('js/app.js') }}" defer></script>
    <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js" defer></script>
    
    defer属性的执行规则是在DOM解析完成后,按照脚本在HTML中的书写顺序执行,这样就能保证先加载app.js内置的jQuery核心,再加载jQuery UI插件,不会出现插件找不到挂载目标的问题。
  3. 校验jQuery的全局暴露配置
    打开resources/js/app.js文件,确认存在jQuery全局绑定的代码,如果缺失就手动补上:
    window.$ = window.jQuery = require('jquery');
    
    这一步是避免Laravel Mix编译配置改动后,jQuery没有正确挂到window全局对象上,导致UI插件无法挂载方法。
  4. 补充加载状态兜底
    调整原来的datepicker初始化脚本,增加方法存在性判断,避免偶发时序问题触发报错:
    把scriptForm区块里的代码替换成如下逻辑:
    document.addEventListener('DOMContentLoaded', function() {
        // 确认datepicker方法存在再执行初始化
        if (typeof $.fn.datepicker === 'undefined') {
            console.error('jQuery UI 插件加载未完成,请检查资源引入');
            return;
        }
        var dateFormat = "mm/dd/yy",
            from = $( "#from" )
                .datepicker({
                    defaultDate: "+1w",
                    changeMonth: true,
                    numberOfMonths: 3
                })
                .on( "change", function() {
                    to.datepicker( "option", "minDate", getDate( this ) );
                }),
            to = $( "#to" ).datepicker({
                defaultDate: "+1w",
                changeMonth: true,
                numberOfMonths: 3
            })
                .on( "change", function() {
                    from.datepicker( "option", "maxDate", getDate( this ) );
                });
    
        function getDate( element ) {
            var date;
            try {
                date = $.datepicker.parseDate( dateFormat, element.value );
            } catch( error ) {
                date = null;
            }
            return date;
        }
    })
    
额外注意点
  • 把原来用协议相对路径的jQuery UI CSS链接改成带完整HTTPS前缀的形式,避免本地开发或内网环境下出现资源加载失败:
    <link rel="stylesheet" href="https://code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">
    
  • 打开浏览器开发者工具的Network面板,确认所有jQuery、jQuery UI的资源请求都返回200状态码,没有被广告拦截插件、网络防火墙拦截——很多时候配置逻辑正确,实际资源因为拦截根本没加载下来,也会触发相同的报错。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 07:45:05