React+WebRTC部署服务器遇iisnode 500(1001)错误求助

一、先定位核心错误 #

HRESULT:0x2本质是文件未找到，优先查这几个点：

• 打开web.config，检查<iisnode>节点的nodeProcessCommandLine，确认Node.js路径和服务器实际安装路径完全一致，比如服务器Node装在C:\Program Files\nodejs\node.exe，就不能写错路径，路径错误直接触发该报错。
• 核对web.config中handler的path是否指向后端入口文件（如server.js、app.js），路径要和服务器上的文件位置完全匹配，别写错文件名或层级。

二、权限与文件完整性检查 #

• 给网站根目录添加IIS_IUSRS和IUSR用户的读写权限，尤其是node_modules文件夹和iisnode日志目录，无权限会导致进程无法正常运行。
• 不要直接上传本地的node_modules到服务器，在服务器端进入网站根目录，执行npm install重新安装依赖，避免本地与服务器系统差异导致的包损坏。

三、通过日志定位具体问题 #

• 修改web.config开启iisnode日志：

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

  触发报错后，前往网站根目录的iisnode文件夹查看日志文件，里面会有详细错误栈，比如模块加载失败、端口占用等，这是最直接的排查依据。

四、Socket.IO与Peer的特殊配置 #

• IIS环境下运行Socket.IO必须开启WebSocket支持：打开IIS管理器，找到目标网站，启用WebSocket协议功能，否则Socket连接会失败。
• Peer服务器端口需在IIS允许范围内，或在web.config中配置端口转发，避免端口被IIS拦截。

后续学习方向 #

• 吃透IISNode配置逻辑，重点掌握web.config核心节点、权限设置、日志分析方法，服务器上的iisnode安装目录内有配置示例，可直接参考。
• 学习Node.js部署到IIS的主流方案：要么用iisnode配合PM2管理进程，要么用IIS反向代理转发Node服务，后者稳定性更高。
• 深入WebRTC生产部署要点：比如自行搭建STUN/TURN服务器（公共STUN在生产环境稳定性不足）、处理跨域问题、端口映射规则等，这些都是新手易踩的坑。

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