解决Next.js独立版通过iisnode部署至IIS的500内部服务器错误

1. 修正IIS站点路径与配置 #

确保IIS站点物理路径指向.next/standalone文件夹，同时在web.config中配置正确的工作目录与进程路径：

<configuration>
  <system.webServer>
    <iisnode 
      processPath="node.exe" 
      arguments=".\server.js" 
      workingDirectory=".\\" 
      stdoutLogEnabled="true" 
      stdoutLogFile=".\logs\node.log"
      devErrorsEnabled="true"
    />
    <handlers>
      <add name="iisnode" path="server.js" verb="*" modules="iisnode" />
    </handlers>
    <rewrite>
      <rules>
        <!-- 静态资源直接访问规则，需放在前面 -->
        <rule name="HandleStaticAssets" stopProcessing="true">
          <match url="^(.next/static|public)/.*$" />
        </rule>
        <rule name="NodeInspector" patternSyntax="ECMAScript" stopProcessing="true">
          <match url="^server.js\/debug[\/]?" />
        </rule>
        <rule name="HandleNextJs">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="server.js" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

重点确认workingDirectory指向站点根目录（即.next/standalone路径），避免路径解析混乱。

2. 对齐静态资源目录结构 #

使用output: "standalone"后，需保证静态资源路径与Next.js预期一致：

• 将public文件夹直接放在.next/standalone根目录下
• 将.next/static移动到.next/standalone/.next/static，保持构建后的相对路径结构
• 上述web.config中的静态资源规则会直接返回这些文件，无需经过Node.js处理

3. 配置IIS进程权限 #

IIS默认运行账户（IIS_IUSRS、IUSR）需要对.next/standalone文件夹有读写执行权限：

• 右键目标文件夹 → 属性 → 安全 → 编辑
• 添加IIS_IUSRS和IUSR账户，分配「读取 & 执行」「列出文件夹内容」「读取」权限

4. 显式指定Next.js路径配置 #

修改server.js中的Next初始化代码，强制指定应用根目录与静态资源路径：

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

const dev = process.env.NODE_ENV !== "production";
const port = process.env.PORT || 3000;
const app = next({ 
  dev,
  dir: __dirname, // 显式绑定应用根目录
  conf: {
    distDir: '.next', // 对应standalone内的.next文件夹
  }
});
const handle = app.getRequestHandler();

app.prepare().then(() => {
    createServer((req, res) => {
        const parsedUrl = parse(req.url, true);
        handle(req, res, parsedUrl);
    }).listen(port, (err) => {
        if (err) throw err;
        console.log(`> Ready on http://localhost:${port}`);
    });
});

同时确保部署环境的NODE_ENV环境变量设置为production。

5. 查看详细日志定位问题 #

通过IISNode日志获取完整错误信息：

• 确保web.config中stdoutLogEnabled="true"
• 访问站点后查看.next/standalone/logs/node.log，里面会记录Node.js进程的完整报错，帮助定位具体的路径或依赖问题

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