摘要：本文档旨在解决在使用Node.js和Puppeteer生成多页PDF时遇到的路由冲突问题。我们将分析导致 "invalid input syntax for type bigint" 错误的根本原因，并提供修改路由以避免冲突的有效方法，确保程序能够正确处理 "all" 参数，生成包含所有ID的PDF文件。
在构建Node.js应用程序，特别是涉及动态路由和数据库交互时，路由冲突是一个常见的问题。当多个路由模式可以匹配同一个URL时，服务器可能会选择错误的路由处理请求，导致意外的错误。本教程将探讨如何避免在使用Express.js和Puppeteer生成PDF文件时遇到的这类问题。
问题分析
错误信息 "error: invalid input syntax for type bigint: "all"" 表明数据库查询期望一个数字类型的ID，但实际接收到了字符串 "all"。这通常发生在路由参数被错误地传递给数据库查询时。
在提供的代码中，问题出在以下路由定义：
router.get('/:database/:tipo/:ids/:limite?.pdf', async (req, res) => { ... });当请求的URL为 /:database/:type/all.pdf 时，Express.js的路由匹配机制可能会将其解析为以下参数：
- database: 数据库名称
- tipo: 类型
- ids: "all"
- limite: undefined
然而，由于存在另一个路由 router.get('/:database/:tipo/:id.pdf') 用于生成单个PDF，当请求 /:database/:tipo/all.pdf 时，Express.js可能会将 all 错误地解析为 :id 参数，导致后续的数据库查询出错。
解决方案：修改路由
避免路由冲突最直接的方法是修改其中一个路由的定义，使其不再与另一个路由发生重叠。根据提供的解决方案，将生成多个PDF的路由的 .pdf 后缀更改为 .pdfs 可以有效解决问题。
修改后的路由定义如下：
router.get('/:database/:tipo/:ids/:limite?.pdfs', async (req, res) => { ... });现在，请求 /:database/:tipo/all.pdfs 将明确匹配到新的路由，而不会与生成单个PDF的路由发生冲突。
代码示例（修改后的路由）
以下是修改后的代码示例，重点在于路由的更改：
router.get('/:database/:tipo/:ids/:limite?.pdfs', async (req, res) => {
const { database, tipo, ids, limite } = req.params;
let idsArray;
if (ids === "all") {
const pool = new Pool({
user: process.env.POSTGRES_USER,
host: process.env.POSTGRES_HOST,
database: database,
password: process.env.POSTGRES_PASSWORD,
port: process.env.POSTGRES_PORT,
});
let query = `SELECT DISTINCT id FROM controle_interno.${tipo} ORDER BY id ASC`;
if (limite) {
query += ` LIMIT ${limite}`;
}
const result = await pool.query(query);
idsArray = result.rows.map(row => row.id);
} else {
idsArray = ids.split(",");
}
const pdfs = [];
const browser = await puppeteer.launch();
const page = await browser.newPage();
for (let i = 0; i < idsArray.length; i++) {
const id = idsArray[i];
const url = `http://localhost:${port}/${database}/${tipo}/${id}`;
console.log(url);
try {
await page.goto(url, {waitUntil: 'networkidle0'});
await page.evaluate(() => {
const button = document.getElementById('gerar-pdf');
button.remove();
});
const pdfBytes = await page.pdf({ format: 'A4', printBackground: true, pageRanges: '1' });
pdfs.push(await PDFDocument.load(pdfBytes));
} catch (err) {
console.error(err.stack);
}
}
await browser.close();
const mergedPdf = await PDFDocument.create();
for (const pdf of pdfs) {
const copiedPages = await mergedPdf.copyPages(pdf, pdf.getPageIndices());
copiedPages.forEach((page) => mergedPdf.addPage(page));
}
const pdfBytes = await mergedPdf.save();
const filePath = path.join(__dirname, 'relatorio.pdf');
await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
await fs.promises.writeFile(filePath, pdfBytes);
res.set({
'Content-Type': 'application/pdf',
'Content-Disposition': 'attachment; filename=relatorio.pdf',
'Content-Length': pdfBytes.length
});
const stream = fs.createReadStream(filePath);
stream.pipe(res);
res.on('finish', async () => {
// apaga o arquivo do diretório
await fs.promises.unlink(filePath)});
});注意事项：
- 确保所有客户端代码（例如前端JavaScript）也更新为使用新的路由URL（例如，将 all.pdf 更改为 all.pdfs）。
- 在部署更改之前，彻底测试所有相关的路由，以确保没有引入新的问题。
总结
路由冲突是Node.js开发中需要注意的问题。通过仔细设计路由模式，并避免重叠或模糊的定义，可以有效地防止这类问题的发生。在本例中，通过简单地修改路由后缀，成功解决了 "invalid input syntax for type bigint" 错误，并确保了应用程序能够正确处理生成多个PDF的请求。在实际开发中，应该始终优先考虑路由的清晰性和可维护性，以提高应用程序的健壮性。
