Windows 系统下 Rails 应用程序的 ExecJS::RuntimeError 错误排查指南

ExecJS::RuntimeError：在 Windows 系统上找不到 JavaScript 运行时

问题

在 Windows 系统上运行 Rails 应用程序时，使用 ExecJS gem 加载 JavaScript 资产会出现 ExecJS::RuntimeError 错误。此错误表明系统找不到 JavaScript 运行时环境。

成因分析

此错误通常由以下原因之一引起：

• Node.js 未安装 ：Node.js 是 ExecJS 所需的 JavaScript 运行时环境。
• Node.js 版本过旧 ：ExecJS 需要 Node.js 版本 4 或更高。
• 未安装兼容的 JavaScript 运行时环境 ：对于 Windows 系统，建议使用 Therubyracer。

解决步骤

1. 安装 Node.js

从 Node.js 官网下载并安装最新稳定版 Node.js，并将其添加到系统路径中。

2. 检查 Node.js 版本

运行命令 node --version 检查 Node.js 版本。确保版本为 4 或更高。

3. 安装 Therubyracer

在 Gemfile 中添加 gem 'therubyracer' 并运行 bundle install 安装 Therubyracer。

4. 更新 ExecJS

在 Gemfile 中将 execjs 版本更新到 ~> 2.9 并运行 bundle update 更新 ExecJS。

5. 重启 Rails 服务器

重启 Rails 服务器以加载更新后的配置。

额外提示

• 检查控制台日志中是否有其他错误消息。
• 查看 Rails 指南中的故障排除部分：https://guides.rubyonrails.org/debugging_rails_applications.html。
• 在 Rails 论坛或 Stack Overflow 上搜索类似问题。

示例代码

# Gemfile
gem 'execjs', '~> 2.9'
gem 'therubyracer'

# application.js
//= require jquery
//= require jquery_ujs
//= require turbolinks
//= require_tree .

常见问题解答

1. 仍然遇到错误怎么办？

• 尝试更新 Node.js 和 ExecJS 到最新版本。
• 检查控制台日志中是否有任何其他错误消息。

2. 除了 Therubyracer 之外，还有哪些 JavaScript 运行时环境可用？

• Rubinius

3. 如何在 Rails 5 及以上版本中使用 Webpacker 代替 ExecJS？

• 在 Gemfile 中添加 gem 'webpacker' 并运行 bundle install 安装 Webpacker。
• 按照 Webpacker 指南配置 Webpack。

4. 如何将 JavaScript 资产从 ExecJS 迁移到 Webpacker？

• 使用 Webpacker 的 javascript_pack_tag 助手。
• 将 //= require 语句替换为 import 语句。

5. 为什么在 Windows 系统上使用 Therubyracer？

• Therubyracer 是专为 Windows 系统设计的 JavaScript 运行时环境，性能优异。