Rails6 Webpacker安装jQuery时application.js不生效
Rails 6 项目jQuery安装失效、文件改动不同步问题
故障现象
- 项目基于Rails 6框架,通过yarn安装jQuery后,所有jQuery绑定的交互功能始终无法触发
- 打开Chrome开发者工具的资源加载面板核对,发现本地修改的application.js内容,没有同步到浏览器实际加载的线上文件中

现有项目配置
application.html.erb
<%= javascript_pack_tag 'application', 'data-turbolinks-track': 'reload' %
application.js
require("@rails/ujs").start() require("turbolinks").start() require("@rails/activestorage").start() require("channels") require("jquery") import "boostrap"
environment.js
const { environment } = require('@rails/webpacker') const webpack = require('webpack') environment.plugins.prepend('Provide', new webpack.ProvidePlugin({ $: 'jquery/src/jquery', jQuery: 'jquery/src/jquery' }) ) module.exports = environment
其他环境说明
- Gemfile中指定webpacker版本为
gem 'webpacker', '~> 4.0' - jQuery依赖通过执行
yarn add jquery安装 - 已尝试的操作:删除public目录、执行
bundle exec rake assets:clean,问题未解决
核心故障原因与修复步骤
清理操作范围匹配错误
Webpacker 4的编译产物、缓存路径与旧版Asset Pipeline的路径完全独立。之前执行的bundle exec rake assets:clean仅会清理public/assets目录下的旧管线文件,不会触及webpack的编译缓存、以及public/packs目录下的打包产物,根本无法触发文件更新。
正确的清理执行命令:rm -rf node_modules/.cache rm -rf public/packs配置文件存在语法、拼写错误,导致webpack编译中断
- 原
application.html.erb中的javascript_pack_tag代码缺少结尾的闭合>,会导致ERB模板渲染报错,无法正确注入打包后的JS资源,需要补全标签闭合 - 原
application.js中导入bootstrap时拼写错误,写为import "boostrap",错误的导入路径会直接导致webpack编译失败,浏览器会持续加载上一次编译成功的旧版本文件,自然看不到新写的require("jquery")相关改动 - 原
environment.js中ProvidePlugin的jQuery路径配置错误,手动指定jquery/src/jquery的路径在webpacker4匹配的jQuery版本中无法正确解析,即使文件加载成功,全局$、jQuery变量也不会被注入,jQuery功能会完全失效
修正后的environment.js参考配置:
const { environment } = require('@rails/webpacker') const webpack = require('webpack') environment.plugins.prepend('Provide', new webpack.ProvidePlugin({ $: 'jquery', jQuery: 'jquery' })) module.exports = environment- 原
未重启webpack监听进程
所有webpack相关的配置、入口文件修改完成后,必须重启webpack的watch进程,才会触发全量重新编译。直接执行命令启动编译服务即可:./bin/webpack-dev-server编译完成后刷新页面,在开发者工具的网络面板中检查加载的JS文件,确认新写入的
require("jquery")、全局$变量注入的代码已经存在,即可正常使用jQuery功能。
内容的提问来源于stack exchange,提问作者Gaston
相关产品推荐
相关产品推荐

