Rails 5 JavaScript资产管道问题：自定义JS加载异常排查

嘿，看你的描述，应该是在Rails资产管道加载JS的时候碰钉子了吧？结合你给的配置细节，我整理了几个最可能的问题点和对应的解决步骤，你可以挨个排查试试：

1. Turbolinks 搞砸了 $(document).ready #

你在Application.js里引入了Turbolinks，这东西为了加快页面跳转，不会每次都重新加载整个文档。那传统的$(document).ready()就只会在第一次打开页面时触发，后续页面切换根本不会执行你的notie提示。

解决办法很简单：

• 换成Turbolinks兼容的事件监听，把你的内联JS改成：

  $(document).on('turbolinks:load', function() {
    notie.alert(1, "It Works", 2);
  });
  

• 要是你根本不需要Turbolinks，直接在Application.js里删掉//= require turbolinks这一行，然后重启服务器就行。

2. 资产加载顺序或路径错了 #

你Application.js里的require顺序看起来没问题（jQuery在最前面，依赖它的库在后面），但还是要仔细核对：

• 检查theme/jquery、theme/notie这些文件是不是真的在app/assets/javascripts/theme/目录下，文件名有没有写错（比如是不是jquery.js，不是jquery.min.js？如果是min版，要把require路径改成对应的）。
• 你最后写的//= require theme/a...是不是没写完？要是漏了某个库的引用，补上之后再测试。

3. 开发环境的资产配置没调好 #

打开config/environments/development.rb，确认这两个配置是对的：

config.assets.debug = true # 开启这个会让资产分开加载，方便你在浏览器里查哪个文件没加载
config.assets.compile = true # 允许动态编译未预编译的资产

改完配置一定要重启Rails服务器，不然不会生效。

4. 别直接在布局写内联JS，换个规范点的方式 #

与其在布局底部写内联代码，不如把这段notie的逻辑放到单独的文件里，比如新建app/assets/javascripts/custom.js，把代码放进去，然后在Application.js最后加一行//= require custom。这样更符合Rails资产管道的规范，也方便后续维护。

5. 先确认notie库真的加载了 #

打开浏览器开发者工具（按F12），切换到Console标签，直接输入notie按回车。如果返回undefined，说明notie根本没加载成功，那就要回头检查：

• theme/notie对应的文件是否存在
• Application.js里的require顺序是不是在jQuery之后，你的自定义代码之前

按照上面的步骤挨个试，应该能解决你的资产管道问题。

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