如何在IIS Server 10部署Next.js 13应用？是否需配置iisnode与rewrite？

一、是否必须配置iisnode和URL Rewrite？ #

这取决于你的部署方式：

• 静态导出部署（next export）：不需要iisnode，但需要URL Rewrite。静态导出会生成纯静态HTML/CSS/JS文件，IIS可直接托管，但Next.js的单页路由需要Rewrite规则把非文件/目录的请求转发到index.html，否则刷新页面会出现404。
• Node.js服务部署（next start）：必须同时配置iisnode和URL Rewrite。iisnode的作用是让IIS能够托管并运行Node.js进程，而Rewrite规则负责把所有HTTP请求转发给Node.js服务处理，包括API路由、SSR页面等。

二、web.config配置差异的原因 #

不同文章的配置差异主要源于以下几点：

• 部署方式（静态/服务端渲染）不同，配置逻辑完全不同
• Next.js版本差异：新版Next.js的服务启动逻辑可能有变化
• iisnode版本或配置偏好：比如是否指定Node.js路径、是否开启日志等
• 是否需要处理特殊场景：比如自定义API路由、静态资源缓存、HTTPS跳转等

三、部署错误通用排查步骤 #

1. 先明确部署类型

   • 静态导出：确认next export已成功生成out文件夹，web.config使用静态路由规则：

     <configuration>
       <system.webServer>
         <rewrite>
           <rules>
             <rule name="Next.js Static Routes" stopProcessing="true">
               <match url=".*" />
               <conditions>
                 <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                 <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
               </conditions>
               <action type="Rewrite" url="/index.html" />
             </rule>
           </rules>
         </rewrite>
       </system.webServer>
     </configuration>
     

   • Node.js服务：确保已安装iisnode和URL Rewrite模块，web.config配置示例：

     <configuration>
       <system.webServer>
         <handlers>
           <add name="iisnode" path="server.js" verb="*" modules="iisnode" />
         </handlers>
         <rewrite>
           <rules>
             <rule name="Forward to Next.js Server">
               <match url="/*" />
               <action type="Rewrite" url="server.js" />
             </rule>
           </rules>
         </rewrite>
         <iisnode nodeProcessCommandLine="C:\Program Files\nodejs\node.exe" loggingEnabled="true" />
       </system.webServer>
     </configuration>
     

     对应的server.js需要正确启动Next.js服务：

     const next = require('next');
     const http = require('http');
     const url = require('url');
     
     const isDev = process.env.NODE_ENV !== 'production';
     const app = next({ dev: isDev });
     const handleRequest = app.getRequestHandler();
     
     app.prepare().then(() => {
       http.createServer((req, res) => {
         const parsedUrl = url.parse(req.url, true);
         handleRequest(req, res, parsedUrl);
       }).listen(process.env.PORT || 3000);
     });
     

2. 关键检查项

   • 确认IIS模块中已安装iisnode和URL Rewrite（可在IIS管理器的「模块」列表中查看）
   • 将应用池的.NET CLR版本设置为无托管代码
   • 确保应用池权限足够：能访问Node.js安装目录和你的Next.js应用文件
   • 查看iisnode日志：日志默认生成在应用目录下的iisnode文件夹中，里面会包含具体错误信息（比如Node.js版本不兼容、依赖缺失等）

内容的提问来源于stack exchange，提问作者Eranda Kuruneru