无法加载文件，因系统禁止运行脚本：PM2启动失败

Question

在Windows系统中使用PM2启动Node.js应用时，常出现“无法加载文件，因为在此系统上禁止运行脚本”的错误。该问题通常由PowerShell执行策略（Execution Policy）限制引起。默认情况下，系统禁止运行未签名的脚本，导致PM2相关的启动命令被阻止。即使全局安装了PM2，当通过`pm2 start app.js`调用时，实际会触发PowerShell执行脚本，从而触发安全策略拦截。此问题多见于开发人员首次配置环境或系统策略未调整的场景，影响服务正常部署与运行。

Answer 1

Windows系统中PM2启动Node.js应用时脚本执行被禁止的深度解析与解决方案

1. 问题现象：PowerShell执行策略拦截PM2命令

在Windows环境下，开发人员常使用PM2管理Node.js进程。然而，执行pm2 start app.js时，系统可能抛出如下错误：

无法加载文件 C:\Users\username\AppData\Roaming\npm\pm2.ps1，因为在此系统上禁止运行脚本。
有关详细信息，请参阅 https://go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

该提示明确指出：PowerShell因执行策略限制，拒绝运行pm2.ps1脚本。尽管PM2已通过npm全局安装，但其在Windows中是以PowerShell脚本形式封装调用的，因此受制于系统的安全策略。

2. 根本原因分析：PowerShell执行策略机制

PowerShell默认执行策略为Restricted，意味着不允许运行任何脚本，仅允许交互式命令输入。此策略是Windows安全模型的一部分，旨在防止恶意脚本自动执行。

PM2在Windows上的可执行入口并非原生二进制文件，而是由npm生成的.ps1 PowerShell脚本（位于%APPDATA%\npm\目录下），当用户输入pm2命令时，实际触发的是PowerShell解释器执行该脚本。

因此，即使Node.js和PM2均已正确安装，若执行策略未调整，系统将阻止脚本运行，导致命令失败。

3. 常见执行策略类型对比

策略名称	描述	适用场景
Restricted	默认策略，禁止所有脚本执行	高安全性环境
RemoteSigned	本地脚本无限制，远程脚本需签名	开发与测试环境推荐
AllSigned	所有脚本必须由可信发布者签名	企业生产环境
Unrestricted	允许所有脚本执行，仅提示警告	完全信任的开发机器
Bypass	不阻止也不提示，完全绕过策略	自动化脚本或CI/CD环境

4. 解决方案层级递进

1. 临时绕过策略（单次执行）：
   使用Powershell -ExecutionPolicy Bypass -Command "pm2 start app.js"临时绕过限制，适用于CI/CD脚本或一次性任务。
2. 修改当前用户执行策略：
   在管理员权限的PowerShell中执行：
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   此方式仅影响当前用户，无需管理员权限即可运行PM2，推荐开发人员使用。
3. 系统级策略调整（谨慎操作）：
   Set-ExecutionPolicy RemoteSigned
   影响所有用户，需管理员权限，适用于团队统一开发环境配置。
4. 使用CMD或Git Bash替代：
   在非PowerShell终端（如cmd.exe或Git Bash）中运行PM2，可避免触发PowerShell策略，因其调用的是pm2.cmd而非pm2.ps1。
5. 配置IDE或编辑器终端环境：
   若在VS Code等工具中遇到此问题，可在设置中指定默认终端为Command Prompt或Git Bash，规避PowerShell限制。

5. 自动化诊断流程图

graph TD
    A[执行 pm2 start app.js] --> B{是否报错“禁止运行脚本”?}
    B -- 是 --> C[检查当前执行策略]
    C --> D[PowerShell中运行 Get-ExecutionPolicy]
    D --> E{策略是否为 Restricted?}
    E -- 是 --> F[建议设置为 RemoteSigned]
    E -- 否 --> G[检查脚本路径权限]
    F --> H[执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser]
    H --> I[验证PM2是否正常]
    I --> J[成功启动应用]
    B -- 否 --> J

6. 安全性权衡与最佳实践

虽然放宽执行策略可解决问题，但需评估安全风险。在企业环境中，应避免使用Unrestricted或Bypass策略。推荐采用以下最佳实践：

• 开发机器使用RemoteSigned策略，平衡安全与便利；
• 生产服务器应通过服务封装PM2（如使用pm2-windows-service），避免直接依赖PowerShell；
• 结合组策略（GPO）统一管理开发团队的PowerShell策略；
• 在CI/CD流水线中显式指定-ExecutionPolicy Bypass，确保构建稳定性；
• 定期审计脚本执行日志（通过Event Viewer中的PowerShell日志通道）。

7. 高级部署场景：PM2与Windows服务集成

对于需要长期驻留的Node.js应用，建议将PM2注册为Windows服务，避免依赖用户会话和PowerShell环境。可通过以下工具实现：

# 安装PM2 Windows服务模块
npm install -g pm2-windows-service

# 初始化服务配置
pm2-service-install

# 启动服务
net start "PM2"

该方式将PM2进程托管于Windows服务控制管理器（SCM），彻底脱离PowerShell执行上下文，从根本上规避执行策略问题。

8. 跨平台兼容性设计建议

现代Node.js项目常需跨平台部署。为提升兼容性，建议在项目文档中明确标注：

• Windows开发者需配置PowerShell策略或使用Git Bash；
• 提供package.json中的跨平台启动脚本示例：

"scripts": {
  "start": "pm2 start app.js",
  "start:win": "powershell -ExecutionPolicy Bypass -Command \"pm2 start app.js\""
}

通过条件脚本或构建工具（如cross-env、scripty）实现自动化适配。