将Nuxt3项目部署到本地IIS时遇iisnode错误，求解决方法

1. 开启iisnode日志获取详细错误信息 #

修改站点根目录的web.config，找到<system.webServer><iisnode>节点，将loggingEnabled设置为true：

<iisnode loggingEnabled="true" devErrorsEnabled="true" />

重启IIS站点后，在站点根目录的iisnode文件夹中查看stdout.log和stderr.log，这两个日志会记录Node.js进程的具体报错细节，是排查问题的核心依据。

2. 确认Nuxt3构建产物与web.config配置正确 #

• 确保已执行npm run build生成.output文件夹，且将.output内所有文件部署到IIS站点根目录
• 检查web.config中的iisnode配置，确保指向正确的服务端入口文件：

  <handlers>
    <add name="iisnode" path=".output/server/index.mjs" verb="*" modules="iisnode" />
  </handlers>
  <rewrite>
    <rules>
      <rule name="Nuxt3">
        <match url="/*" />
        <action type="Rewrite" url=".output/server/index.mjs" />
      </rule>
    </rules>
  </rewrite>
  

• 同时指定正确的Node.js路径，避免版本不兼容：

  <iisnode nodeProcessCommandLine="C:\Program Files\nodejs\node.exe" />
  

3. 检查IIS应用程序池配置 #

• 将应用程序池的**.NET CLR版本**设置为无托管代码，Node.js项目不需要依赖.NET运行时
• 验证应用程序池的身份权限：确保应用池身份（如ApplicationPoolIdentity）对站点目录有读取和执行权限，必要时可临时切换为LocalSystem测试是否为权限问题

4. 验证Node.js版本兼容性 #

Nuxt3要求Node.js版本≥v16，建议使用LTS版本（v18或v20）。在服务器上执行node -v确认版本符合要求，同时确保iisnode能通过环境变量PATH正确找到Node.js的安装路径。

5. 本地启动生产服务排查代码问题 #

在服务器上进入站点目录，执行以下命令直接启动Nuxt3生产服务：

node .output/server/index.mjs

如果启动失败，控制台会直接输出错误信息，可快速定位是代码/依赖问题还是IIS配置问题。

内容的提问来源于stack exchange，提问作者董政威