FIS3+mod.js开发方案在线上部署时出现没法找到文件的bug的解决过程

在项目中，咱们选择了百度FIS3+MODJS+VUEJS的方案进行前端开发，这套方案具体能够看这里：
https://github.com/zhangtao07/fis-vuejs-seed

本地开发过程很是顺利，第一次线上部署也很是顺利，一切彷佛都在平稳进行着。然而在今天上午的一次更新部署之后，出现了意想不到的事情。

咱们线上更新代码是经过把fis3 release出来的文件放入服务器文件目录内，再重启服务器的方式进行的。在以前的屡次修改中都没有出现问题，可是在今天上午，我把两个新写的js文件添加到服务器文件目录内，按照以往的更新方式进行后，发现控制台报错，错误缘由是mod.js没法找到对应的js文件。

项目使用的是异步加载的方式，何时须要这个js就直接把它require进来。今天上午的bug就是出如今这里，新添加的两个js文件居然require不出来了。

首先我仔细检查了文件的引用路径，和可以成功加载的文件的写法是如出一辙的，排除了文件路径的问题；
接着对其余页面进行debug，由于以前也试过若是上一个页面报错，会影响这个页面的进行。排除其余页面的错误以后，问题依然存在。
打开chrome控制台，在network里面监视文件请求，发现require路径报404错误，而且发现其content-type为text，而非正常的javascript，同时同事无心中的一句吐槽也引发了个人注意：“很奇怪呀，第一次部署上去的均可以，修改里面的代码也没问题，可是把文件改个名字或者添加新的文件就出问题了。”

经过仔细分析，认为这个bug并未由写错路径之类的低级错误引发的，而是在FIS3编译过程当中出现问题或者mod.js进行文件引用的过程当中出现问题引发的。

带着这个想法，我首先研究了一下FIS3的config文件，没有找到关键点。初步排除是FIS3编译的问题。
接着在github上，找到百度fex-team所在的mod.js项目，发现有这么一个提问：
https://github.com/fex-team/mod/issues/16#issuecomment-100741125
其中关键的点是这一句：

mod.js 在产出的时候不是以一个完整的 loader 存在的，为了配合 fis 的包括md五、cdn等等功能，须要在加载使用时，给 mod.js 一个静态资源列表

我想我找到了缘由。
mod.js并不是直接经过写在require('xxxxx')的方式引入文件，而是经过一张静态资源列表所得到。若是这张表没有记录这个路径，那么mod.js是不可能把资源加载进来的。

这个列表是由后端经过查询 fis 产出的静态资源列表 map.json 获得的。

也就是说，这个表应该是在我FIS3的产出目录或者产出文件中。后打开服务器目录，找到对应文件，真的发现有着这么一份静态资源列表：

require.resourceMap({
  "res": {
    "project/component/xxx/xx": {
      "url": "/project/component/xxx/xx.js",
      "type": "js"
    },
     "pkg":[]
});

问题终于明了。原来是咱们只顾着添加新的文件，更新资源的引用路径，却没有更新这份静态资源列表！因此才会出现第一次部署成功，可是修改文件名或者新增长文件的时候出现bug（由于这份静态资源列表存放在一个几乎不用更改的文件内，因此线上部署的时候这个文件依然是沿用着旧版）。
立刻给这份静态资源列表进行更新，部署，重启服务器，测试……
测试经过。
bug终于解决！！

后来仔细回想，其实这也算是低级错误，由于居然遗漏了部署前对文件内容进行对比的步骤。对构建工具的编译流程的不熟悉，对模块加载器加载原理的不了解也是形成bug的缘由。从此在开发中必定要对每个环节都了如指掌，才能避免在知识的空白中出现问题。