swagger 工具错误处理程序中间件未捕获错误
swagger tools error handler middleware not catching errors
概述
我的自定义 errorHandler 中间件没有捕获 swagger-tools 请求验证器错误。相反,swagger 工具 HTML 错误被发送回客户端。如何让我的 errorHandler 中间件捕获 swagger 工具验证错误并相应地响应客户端?
我的预后
不幸的是,我很无能。无论我将 app.use(errorHandler) 指令放在哪里,swagger 工具 html 错误都会返回给客户端,而我的 errorHandler 函数永远不会捕获错误。
也许我忽略了一些明显不正确的设置。下面是我的 app.js 文件,下面是我的 app.js 是返回给客户端的 [undesired] swagger-tools HTML 错误响应。同样,我尝试将 app.use(errorHandler) 按字面意思(比喻)放在任何地方,尽管下面的代码只在两个地方显示它。
app.js
"use strict";
var swaggerTools = require("swagger-tools");
var compression = require("compression");
var app = require("express")();
var logger = require("./config/logger");
var projectConfig = require("./config/projectConfig");
var debug = require("debug")("app-js"); // run this to enable debug logging DEBUG=app-js node app.js
// swaggerRouter configuration
var options = {
controllers: './api/controllers',
useStubs: false
};
// The Swagger document (require it, build it programmatically, fetch it from a URL, ...)
var swaggerDoc = require('./api/swagger/swagger.json');
// compress all requests except those which have Cache-Control header with the no-transform directive
app.use(compression());
// for testing
module.exports = app;
// global error handler
function errorHandler(err, req, res, next, statusCode) {
logger.error(err);
debug(err);
if (res.headersSent) {
return next(err);
} else {
res.status(statusCode || 500).json(projectConfig.genericErrorResponse(statusCode || 500, err.message || err || "something blew up and the err object was undefined"));
}
}
// handles timed out requests
function haltOnTimedout(req, res, next) {
if (!req.timedout) {
next();
} else {
debug("\nrequest timed out!\n");
next("the request timed out", null, null, null, 504);
}
}
// Initialize the Swagger middleware
swaggerTools.initializeMiddleware(swaggerDoc, function (middleware) {
"use strict"
// Interpret Swagger resources and attach metadata to request - must be first in swagger-tools middleware chain
app.use(middleware.swaggerMetadata());
app.use(function (req, res, next) {
res.header("Access-Control-Allow-Origin", "*"); // CORS should be parametrized by configuration
res.header("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
next();
});
// Validate Swagger requests
// app.use(middleware.swaggerValidator());
app.use(middleware.swaggerValidator({
validateResponse: false
}));
app.use(haltOnTimedout);
app.use(errorHandler);
// Route validated requests to appropriate controller
app.use(middleware.swaggerRouter(options));
});
app.use(haltOnTimedout);
app.use(errorHandler);
app.listen(projectConfig.port || process.env.PORT || 9000)
.on("connection", function (socket) {
debug("\na new cxn was made by a client.\n");
socket.setTimeout(projectConfig.expressTimeout || 120000);
})
swagger 工具html 错误返回给客户端
Error: Parameter (copy) failed schema validation
<br> at throwErrorWithCode (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/lib/validators.js:121:13)
<br> at Object.module.exports.validateAgainstSchema (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/lib/validators.js:176:7)
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:143:22
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:356:13
<br> at async.forEachOf.async.eachOf (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:233:13)
<br> at _asyncMap (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:355:9)
<br> at Object.map (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:337:20)
<br> at validateValue (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:136:11)
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:343:21
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:356:13
我是什么版本 运行?
节点:
node --version
v6.2.2
swagger-tools 和 express 的最新版本:
"swagger-tools": "^0.10.1",
"express": "^4.12.3"
关闭
任何帮助 and/or 深入了解如何让我的 errorHandler 中间件捕获并从而覆盖 swagger-tools html 错误将非常有义务。我也在 apigee 社区论坛中发布了我的问题,因为它是 apigee-127 项目的一部分。
https://community.apigee.com/questions/29267/swagger-tools-error-handler-middleware-not-catchin.html
谢谢!
我看到两个问题。
首先:错误处理程序必须有 4 个参数,因此 statusCode 将被忽略。
errorHandler(err, req, res, next) // correct definition
第二名是
next("the request timed out", null, null, null, 504);
错误句柄的第一个参数必须是错误对象而不是字符串,所以正确的代码是
next(new Error("the request timed out")); // other args passed by closure
有很多变体如何传递 statusCode。
// 1. Bad way: Pass string with delimiter
next(new Error("the request timed out;404"));
...
// In error handler
var args = err.message.split() // => args[0] = the request timed out, args[1] = 404
// 2. Check message error text
If (err.message == 'the request timed out')
statusCode = 404;
// 3. Best way is use custom error
关于自定义错误的更多信息here
概述
我的自定义 errorHandler 中间件没有捕获 swagger-tools 请求验证器错误。相反,swagger 工具 HTML 错误被发送回客户端。如何让我的 errorHandler 中间件捕获 swagger 工具验证错误并相应地响应客户端?
我的预后
不幸的是,我很无能。无论我将 app.use(errorHandler) 指令放在哪里,swagger 工具 html 错误都会返回给客户端,而我的 errorHandler 函数永远不会捕获错误。
也许我忽略了一些明显不正确的设置。下面是我的 app.js 文件,下面是我的 app.js 是返回给客户端的 [undesired] swagger-tools HTML 错误响应。同样,我尝试将 app.use(errorHandler) 按字面意思(比喻)放在任何地方,尽管下面的代码只在两个地方显示它。
app.js
"use strict";
var swaggerTools = require("swagger-tools");
var compression = require("compression");
var app = require("express")();
var logger = require("./config/logger");
var projectConfig = require("./config/projectConfig");
var debug = require("debug")("app-js"); // run this to enable debug logging DEBUG=app-js node app.js
// swaggerRouter configuration
var options = {
controllers: './api/controllers',
useStubs: false
};
// The Swagger document (require it, build it programmatically, fetch it from a URL, ...)
var swaggerDoc = require('./api/swagger/swagger.json');
// compress all requests except those which have Cache-Control header with the no-transform directive
app.use(compression());
// for testing
module.exports = app;
// global error handler
function errorHandler(err, req, res, next, statusCode) {
logger.error(err);
debug(err);
if (res.headersSent) {
return next(err);
} else {
res.status(statusCode || 500).json(projectConfig.genericErrorResponse(statusCode || 500, err.message || err || "something blew up and the err object was undefined"));
}
}
// handles timed out requests
function haltOnTimedout(req, res, next) {
if (!req.timedout) {
next();
} else {
debug("\nrequest timed out!\n");
next("the request timed out", null, null, null, 504);
}
}
// Initialize the Swagger middleware
swaggerTools.initializeMiddleware(swaggerDoc, function (middleware) {
"use strict"
// Interpret Swagger resources and attach metadata to request - must be first in swagger-tools middleware chain
app.use(middleware.swaggerMetadata());
app.use(function (req, res, next) {
res.header("Access-Control-Allow-Origin", "*"); // CORS should be parametrized by configuration
res.header("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
next();
});
// Validate Swagger requests
// app.use(middleware.swaggerValidator());
app.use(middleware.swaggerValidator({
validateResponse: false
}));
app.use(haltOnTimedout);
app.use(errorHandler);
// Route validated requests to appropriate controller
app.use(middleware.swaggerRouter(options));
});
app.use(haltOnTimedout);
app.use(errorHandler);
app.listen(projectConfig.port || process.env.PORT || 9000)
.on("connection", function (socket) {
debug("\na new cxn was made by a client.\n");
socket.setTimeout(projectConfig.expressTimeout || 120000);
})
swagger 工具html 错误返回给客户端
Error: Parameter (copy) failed schema validation
<br> at throwErrorWithCode (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/lib/validators.js:121:13)
<br> at Object.module.exports.validateAgainstSchema (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/lib/validators.js:176:7)
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:143:22
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:356:13
<br> at async.forEachOf.async.eachOf (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:233:13)
<br> at _asyncMap (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:355:9)
<br> at Object.map (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:337:20)
<br> at validateValue (/Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:136:11)
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/swagger-tools/middleware/swagger-validator.js:343:21
<br> at /Users/cuv/Documents/dev/dev-project/dev-simple/node_modules/async/lib/async.js:356:13
我是什么版本 运行?
节点:
node --version
v6.2.2
swagger-tools 和 express 的最新版本:
"swagger-tools": "^0.10.1",
"express": "^4.12.3"
关闭
任何帮助 and/or 深入了解如何让我的 errorHandler 中间件捕获并从而覆盖 swagger-tools html 错误将非常有义务。我也在 apigee 社区论坛中发布了我的问题,因为它是 apigee-127 项目的一部分。 https://community.apigee.com/questions/29267/swagger-tools-error-handler-middleware-not-catchin.html
谢谢!
我看到两个问题。
首先:错误处理程序必须有 4 个参数,因此 statusCode 将被忽略。
errorHandler(err, req, res, next) // correct definition
第二名是
next("the request timed out", null, null, null, 504);
错误句柄的第一个参数必须是错误对象而不是字符串,所以正确的代码是
next(new Error("the request timed out")); // other args passed by closure
有很多变体如何传递 statusCode。
// 1. Bad way: Pass string with delimiter
next(new Error("the request timed out;404"));
...
// In error handler
var args = err.message.split() // => args[0] = the request timed out, args[1] = 404
// 2. Check message error text
If (err.message == 'the request timed out')
statusCode = 404;
// 3. Best way is use custom error
关于自定义错误的更多信息here