在IIS部署Next.js项目遇错求助：已装IISNode与URL Rewriter

1. 修复web.config语法错误 #

你提供的web.config存在标签不完整的语法问题：<rewrite>标签缺失起始标签，且<system.webServer>未闭合。修正后的完整配置如下：

<configuration>
  <system.webServer>
    <rewrite>
      <!-- 优先匹配public文件夹下的静态文件 -->
      <rule name="StaticContent">
        <action type="Rewrite" url="public{REQUEST_URI}"/>
      </rule>

      <!-- 其余请求转发到server.js处理 -->
      <rule name="DynamicContent">
        <conditions>
          <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="True"/>
        </conditions>
        <action type="Rewrite" url="server.js"/>
      </rule>
    </rules>
    </rewrite>

    <!-- 隐藏node_modules目录 -->
    <security>
      <requestFiltering>
        <hiddenSegments>
          <add segment="node_modules"/>
        </hiddenSegments>
      </requestFiltering>
    </security>

    <!-- 保留原始错误响应 -->
    <httpErrors existingResponse="PassThrough" />
    <!-- 指定Node.js路径，替换为你的实际安装路径 -->
    <iisnode node_env="production" nodeProcessCommandLine="C:\Program Files\nodejs\node.exe"/>
    <!-- 可选：监听文件变化自动重启服务 -->
    <!--<iisnode watchedFiles="web.config;*.js;pages\*.js"/>-->
  </system.webServer>
</configuration>

2. 确保server.js符合Next.js自定义服务器要求 #

Next.js部署到IIS必须使用自定义服务器，示例代码适配Next.js 13+（支持App Router/Page Router）：

const { createServer } = require('http');
const { parse } = require('url');
const next = require('next');

const dev = process.env.NODE_ENV !== 'production';
const app = next({ dev });
const handle = app.getRequestHandler();

app.prepare().then(() => {
  createServer((req, res) => {
    const parsedUrl = parse(req.url, true);
    handle(req, res, parsedUrl);
  }).listen(process.env.PORT || 3000, (err) => {
    if (err) throw err;
    console.log('> 服务已启动：http://localhost:3000');
  });
});

3. 关键配置与环境检查 #

• Node.js路径配置：必须在<iisnode>标签中通过nodeProcessCommandLine明确指定Node.js的安装路径，避免IISNode无法定位正确的Node版本。
• 目录权限：给IIS应用池的运行身份分配项目目录（包括.next、public文件夹）的读写权限。
• 构建产物：确认已执行npm run build生成.next文件夹，且该文件夹与server.js、web.config处于同一目录。
• 静态资源规则：如果Next.js静态资源路径不是public，需要调整<rule name="StaticContent">的目标URL。

4. 查看错误日志定位问题 #

IISNode会在项目目录下生成iisnode文件夹，里面的日志文件可以直接显示具体错误原因（比如Node版本不兼容、依赖缺失、端口占用等）。

内容的提问来源于stack exchange，提问作者Oguz Demirel