HttpPlatformHandler随机分配端口，但Node.js应用已设为3000端口

我有一个Node.js应用，用npm start启动时运行在3000端口，所有路由都正常工作。但尝试通过IIS的HttpPlatformHandler托管该应用时，每次启动都会分配随机端口，除主页/和SwaggerUI的/api-docs外，其他路由均无法访问。明明server.js中已指定端口，且通过PowerShell执行npm start完全正常，为何会分配随机端口？我认为这是路由无法访问的原因。

server.js代码 #

// MODULES AND REQUIRES
const express = require("express");
const app = express();
const path = require('path');
const swaggerJsDoc = require("swagger-jsdoc");
const swaggerUi = require("swagger-ui-express");
const objectMapper = require('object-mapper');
const cors = require('cors');

// Require Routes
var api1 = require('./routes/api1.js')
var api2 = require('./routes/api2.js')

// PORTS AND BASIC EXPRESS APP SETTINGS
const port = process.env.PORT || 3000;

// CORS ALLOW ALL. NOTE IP RESTRICTIONS ARE IN PLACE
app.use(cors({
  origin: '*'
}));

// ignore request for FavIcon. so there is no error in browser
const ignoreFavicon = (req, res, next) => {
  if (req.originalUrl.includes('favicon.ico')) {
      res.status(204).end();
  }
  next();
};

// Configure nonFeature
app.use(ignoreFavicon);

// Root Route - Serve Static File
app.get('/', (req, res) => {
      res.sendFile(path.join(__dirname, '/public/client.html'));
});

// SWAGGER UI CONFIGURATION

// Primary Swagger Options
const options = {
  customCss: '.swagger-ui .topbar { display: none } .swagger-ui .scheme-container { display: none }'
};

// Custom Swagger Options: https://swagger.io/specification/#infoObject
const swaggerOptions = {
  swaggerDefinition: {
    info: {
      version: "2.0.0",
      title: "My App",
      description: "This page lists the available APIs within my app and allows you to test them.",
      contact: {
        name: "My Name"
      },
      servers: [{"url":"http://localhost:3000", "description": "Development server"}]
    }
  },
  // ['.routes/*.js'] Location for APIs
  apis: ["./routes/*.js"],
};

const swaggerDocs = swaggerJsDoc(swaggerOptions);
app.use("/api-docs", swaggerUi.serve, swaggerUi.setup(swaggerDocs, options));


// ROUTES
  app.use('/api1', api1)
  app.use('/api2', api2)  

// APP LISTEN WITH SSL/HTTPS
app.listen(port, () => {
  console.log(`Server listening on port ${port}`);
});

Web.config代码 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="httppPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" />
    </handlers>
    <httpPlatform stdoutLogEnabled="true" stdoutLogFile=".\logs\node.log" startupTimeLimit="20" processPath="C:\Program Files\nodejs\node.exe" arguments=".\server.js">
            <environmentVariables>
                <environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
                <environmentVariable name="NODE_ENV" value="Production" />
            </environmentVariables>
        </httpPlatform>
  </system.webServer>
</configuration>

问题原因及解决方案 #

核心原因 #

1. 随机端口的来源：Web.config中配置了environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%"，这会强制Node.js应用读取IIS分配的随机端口%HTTP_PLATFORM_PORT%，而非代码中指定的3000端口。这是HttpPlatformHandler的标准工作机制：它会自动分配端口给后端应用，再通过反向代理将外部请求转发到该端口。
2. 路由无法访问的关键：Swagger配置中硬编码了http://localhost:3000作为服务器地址，而实际应用运行在IIS分配的随机端口上，导致Swagger发起的API请求都指向了未被当前应用占用的3000端口，因此除了IIS直接代理的/和/api-docs，其他API路由均无法正常访问。

解决方案 #

1. 适配HttpPlatformHandler的端口机制（推荐）

不需要强行固定端口，只需修正Swagger配置，让它自动适配当前访问地址：
修改server.js中的swaggerOptions配置：

const swaggerOptions = {
  swaggerDefinition: {
    info: {
      version: "2.0.0",
      title: "My App",
      description: "This page lists the available APIs within my app and allows you to test them.",
      contact: {
        name: "My Name"
      },
      // 移除硬编码的localhost:3000，改用相对路径适配当前域名/端口
      servers: [{"url": "/", "description": "Production server"}]
    }
  },
  apis: ["./routes/*.js"],
};

若需要支持动态域名，也可以在请求时动态生成服务器地址：

// 在swagger-ui的setup中动态修改服务器地址
app.use("/api-docs", swaggerUi.serve, (req, res) => {
  const dynamicSwaggerDocs = {
    ...swaggerDocs,
    servers: [{url: `${req.protocol}://${req.get('host')}`}]
  };
  swaggerUi.setup(dynamicSwaggerDocs, options)(req, res);
});

2. 强制固定端口（不推荐）

如果一定要固定为3000端口，需修改Web.config移除PORT环境变量配置，让应用使用代码中指定的端口：

<httpPlatform stdoutLogEnabled="true" stdoutLogFile=".\logs\node.log" startupTimeLimit="20" processPath="C:\Program Files\nodejs\node.exe" arguments=".\server.js">
        <environmentVariables>
            <!-- 移除PORT环境变量配置 -->
            <environmentVariable name="NODE_ENV" value="Production" />
        </environmentVariables>
</httpPlatform>

同时要确保IIS站点绑定端口与应用端口一致，且3000端口未被其他程序占用。但这种方式会失去HttpPlatformHandler的进程管理和反向代理能力，不建议生产环境使用。

3. 验证路由配置

确保api1.js、api2.js中的路由配置正确，比如：

// api1.js示例
const express = require('express');
const router = express.Router();

// 路由基于/api1前缀，访问时路径为/api1/
router.get('/', (req, res) => {
  res.send('api1 接口响应');
});

module.exports = router;

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