Dojo 1.6.2迁移至1.13：登录页Layer优化脚本报错求助

嘿，我之前帮不少团队踩过Dojo跨大版本迁移的坑，尤其是1.x系列从老版本跳转到1.13，layer配置这块的变化真的容易出问题。结合你说的登录页用了TextBox、ComboBox这类dijit组件，还有profile生成login.js layer后报错的情况，我整理了几个最可能的原因和对应的解决办法：

1. Layer依赖声明的语法变更 #

Dojo 1.13全面切换到AMD模块规范，和1.6的旧语法不兼容。比如1.6里你可能这么写依赖：

dependencies: [
    "dijit.form.TextBox",
    "dijit.form.ComboBox"
]

而1.13的profile需要用斜杠分隔的模块路径，并且放在layers配置下：

layers: {
    "login": {
        include: [
            "dijit/form/TextBox",
            "dijit/form/ComboBox"
        ],
        exclude: []
    }
}

别小看路径分隔符的变化，这是很多迁移时layer失效的核心原因。

2. 缺失基础隐式依赖 #

1.6的build工具会自动打包组件的隐式依赖，但1.13的build更严格，必须显式声明。登录页的dijit组件依赖dojo/domReady、dijit/_WidgetBase这类基础模块，你需要把它们加入layer的include列表：

include: [
    "dojo/domReady",
    "dijit/form/TextBox",
    "dijit/form/ComboBox",
    "dijit/_Widget",
    "dijit/_TemplatedMixin"
]

否则就算layer生成了，组件也会因为找不到基础模块初始化失败。

3. 组件依赖的新增模块 #

Dojo 1.13里部分组件的依赖链有变化，比如dijit/form/ComboBox现在依赖dojo/store相关模块。如果你的登录页用了本地数据源，得把dojo/store/Memory这类模块也打包进layer，不然会出现「模块未找到」的报错。

4. Build工具版本不匹配 #

绝对不能用1.6的build脚本去构建1.13的代码！一定要下载Dojo 1.13的完整包，用里面自带的build.sh或build.bat执行构建，命令参数也要符合新版本要求，比如：

./build.sh profile=myProfile action=release optimize=closure

同时检查你的profile顶层配置，必须包含basePath、packages这些1.13要求的项。

5. 页面脚本加载顺序错误 #

有时候layer本身没问题，但PHP页面的脚本加载顺序错了。要确保先加载Dojo核心的dojo.js，再加载login.js，并且开启异步模式：

<script src="/path/to/dojo/dojo.js" data-dojo-config="async: true"></script>
<script src="/path/to/build/login.js"></script>

1.6常用同步模式，而1.13默认推荐异步，这也是常见的冲突点。

如果能提供控制台里的具体报错信息（比如模块未找到、组件初始化失败等），还能更精准定位，但上面这几点应该能覆盖大部分layer相关的报错场景。

内容的提问来源于stack exchange，提问作者Loc Vuong