本文详解 fastify 路由中因混用回调与 async/await 导致响应丢失、数据未加载完成即返回空数组的问题，并提供符合 fastify 最佳实践的同步/异步混合调用修复方案。
本文详解 fastify 路由中因混用回调与 async/await 导致响应丢失、数据未加载完成即返回空数组的问题，并提供符合 fastify 最佳实践的同步/异步混合调用修复方案。
在 Fastify 应用中，当使用 playerio-node 等基于回调（callback）的 SDK 时，开发者常误将异步逻辑包裹在 async 路由处理器中，却未真正 await 回调流程，最终导致 reply 未被调用、响应提前结束或返回空数据（如 items = []）。根本原因在于：Fastify 不会自动等待回调函数执行完毕；它只关心你是否显式调用了 reply.send()、reply.render() 或其他终结响应的方法。
✅ 正确做法：保持回调语义，避免 async/await 与回调混用
Fastify 的路由处理器支持两种风格：
- Callback 风格（推荐用于回调型 SDK）：使用 (req, reply) => { ... }，并在回调链末端调用 reply.*
- Async 风格（推荐用于 Promise API）：使用 async (req, reply) => { return value }，需确保所有异步操作均返回 Promise 并被 await
由于 playerio-node 的 authenticate 和 loadOrCreate 均为纯回调接口（不返回 Promise），强行包装 async 函数并忽略 reply 调用，将导致请求挂起或静默失败。
以下是修复后的标准实现（已移除危险的 async 包裹、req.render 错误调用及未处理的错误分支）：
const db = require('playerio-node');
const auth = require('../../../../../index').hashGenerator('Stock');
const index = async (fastify, options) => {
fastify.get('/pricing', (req, reply) => {
db.PlayerIO.authenticate(
'HIDDEN',
'HIDDEN',
{
userId: 'Stock',
auth
},
{},
// ✅ 成功回调：client 已就绪
(client) => {
client.bigDB.loadOrCreate('StockItems', 'Stock', (obj) => {
// ✅ 安全映射：确保 obj 是有效对象（可加 null/undefined 检查）
const items = (req.config.stockItems || []).map(item => ({
name: item.name,
img: item.img,
price: item.price,
stock: obj?.[item.img] ?? 5 // 使用可选链 + 空值合并更健壮
}));
// ✅ 正确渲染：使用 reply.render（需已注册 point-of-view 插件）
reply.render('/dynamic/pricing/index.liquid', {
stockItems: items,
Chests: req.config.chests
});
});
},
// ✅ 失败回调：必须调用 reply.send() 终止响应，防止超时
(error) => {
fastify.log.error({ error }, 'PlayerIO authentication failed');
reply.status(500).send({ error: 'Failed to load pricing data' });
}
);
});
};
module.exports = index;⚠️ 关键注意事项
- 禁止混用 async 与回调：若路由处理器声明为 async，但内部未 await 任何 Promise，且又未调用 reply.*，Fastify 将认为处理器已“完成”，立即发送空响应（HTTP 200 + 空 body）。
- req.render 不存在：Fastify 本身无此方法；应使用 reply.render()，且需提前通过 point-of-view 注册模板引擎（如 Liquid、EJS）。
- 错误必须终结响应：回调错误分支中务必调用 reply.send() 或 reply.status().send()，否则连接将挂起直至超时，消耗服务资源。
- 空数据防御：对 req.config.stockItems 和 obj 做存在性检查（如 || []、?.），避免 .map() 或属性访问抛出 TypeError。
- 日志增强可观测性：在关键错误路径添加 fastify.log.error()，便于问题定位。
✅ 进阶建议：封装为 Promise（可选）
若项目逐步迁移到 Promise 生态，可手动封装 playerio-node 方法：
const authenticateAsync = (key, secret, user, options) => {
return new Promise((resolve, reject) => {
db.PlayerIO.authenticate(key, secret, user, options, resolve, reject);
});
};
// 后续可配合 async/await 使用（需确保 loadOrCreate 也 Promise 化）但请优先保证当前逻辑稳定——正确使用回调 + 显式 reply，永远比强行 Promise 化更安全、更符合 Fastify 设计哲学。
