Magento2中使用Mixin重写region-updater组件时出现widget未定义错误

云上老周

2026-8-24

问题解决方案

错误原因

出现TypeError: Cannot read properties of undefined (reading 'widget')是因为你的mixin模块未正确引入jQuery和jQuery UI Widget依赖。Magento采用AMD模块机制，全局$不会自动注入到模块中，且$.widget是jQuery UI提供的方法，必须显式声明依赖才能正常使用。

修正后的Mixin代码

define(['jquery', 'jquery-ui-widget'], function ($) {
    return function (widget) {
        'use strict';
        console.log('update');
        
        $.widget('mage.regionUpdater', widget, {
            _updateRegion: function (country) {
                // 在这里编写你的修改逻辑
                // 如需保留原方法功能，可先调用原方法：
                // widget.prototype._updateRegion.call(this, country);
                // 再添加自定义代码
            }
        });
        
        return $.mage.regionUpdater;
    };
});