将IISNode托管的Express服务器接入现有前端站点的问题排查

1. 修正web.config配置 #

你的核心问题是重写规则未匹配/api前缀，且未正确传递请求路径到Express应用。修改后的web.config如下：

<configuration>
<system.webServer>
    <!-- 确保iisnode能处理子应用的所有请求类型 -->
    <handlers>
        <add name="iisnode-api" path="server.js" verb="*" modules="iisnode" resourceType="Unspecified" requireAccess="Script" />
    </handlers>
    <rewrite>
        <rules>
            <!-- 匹配/api开头的所有请求，保留后续路径转发到server.js -->
            <rule name="sendToNodeApi" stopProcessing="true">
                <match url="^api/(.*)" />
                <action type="Rewrite" url="server.js/{R:1}" />
            </rule>
            <!-- 单独处理根路径/api的请求 -->
            <rule name="sendToNodeApiRoot" stopProcessing="true">
                <match url="^api$" />
                <action type="Rewrite" url="server.js/" />
            </rule>
        </rules>
    </rewrite>
    <!-- 可选：配置iisnode日志便于排查问题 -->
    <iisnode logDirectory="iisnode" debuggingEnabled="false" />
</system.webServer>
</configuration>

关键修改点：

• 重写规则明确匹配/api前缀的请求，确保所有相关请求都转发到Express服务
• 通过{R:1}保留请求的后续路径，让Express能正确解析具体路由
• 给handler添加resourceType="Unspecified"和requireAccess="Script"，避免IIS权限拦截

2. 调整Express应用的路由 #

因为请求路径现在是/api/xxx，你需要给所有API路由添加/api前缀，或用路由挂载实现：

方法1：直接给路由加前缀 #

const express = require('express');
const app = express();

// 所有API路由统一添加/api前缀
app.get('/api/users', (req, res) => {
    res.json({ message: '用户列表' });
});

// 处理根路径/api的GET请求
app.get('/api', (req, res) => {
    res.json({ message: 'API根路径' });
});

app.listen(process.env.PORT || 3000);

方法2：用Router挂载前缀 #

const express = require('express');
const app = express();
const apiRouter = express.Router();

// 定义具体路由逻辑
apiRouter.get('/users', (req, res) => {
    res.json({ message: '用户列表' });
});

apiRouter.get('/', (req, res) => {
    res.json({ message: 'API根路径' });
});

// 将路由挂载到/api前缀
app.use('/api', apiRouter);

app.listen(process.env.PORT || 3000);

3. 检查IIS站点配置 #

• 确保父站点（www.mysite.com）已启用iisnode模块：在IIS管理器的父站点“模块”列表中确认存在iisnode
• 子应用物理路径权限：给IIS_IUSRS和IUSR用户分配读取和执行权限
• 关闭父站点的“目录浏览”功能，避免与重写规则冲突
• 检查HTTPS绑定：确保父站点的HTTPS证书有效，且站点绑定包含正确的主机头

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