本文详解 node.js 中使用 contentful sdk 时因混用回调与 promise 导致接口挂起的问题，提供正确使用 `await` 调用 `getentries()` 的标准写法，并强调关键注意事项（如 `items` 属性访问、错误处理和响应结构）。
在 Node.js 后端集成 Contentful CMS 时，一个常见却隐蔽的错误是：错误地将基于 Promise 的 API（如 client.getEntries()）与回调函数和 .catch() 混用。这正是你遇到 /api/courses 接口长时间 pending、浏览器转圈、控制台无报错的根本原因。
原始代码中，你声明了 async 函数，却仍以回调形式调用 getEntries()：
client.getEntries({ /* options */ }, (err, courses) => { ... }).catch(...)⚠️ 问题在于：contentful.js 的 getEntries() 返回 Promise，不接受回调参数。传入回调会被忽略，Promise 既未被 await 等待，也未被 .then() 或 .catch() 显式处理——导致函数提前结束，但异步请求仍在后台运行，Express 无法发送响应，于是连接悬而未决（Hanging Request）。
✅ 正确做法是完全采用 Promise + await 风格，并注意 Contentful 响应结构：
const contentful = require('contentful');
const getCourses = async (req, res) => {
const client = contentful.createClient({
space: '9f3v4l5x639t',
accessToken: 'l83Wr4f12LlnCfo71Jv4NwSyt2x-M1Q0AQ22O5kRuEI'
});
try {
// ✅ 正确：await 返回的 Promise，获取完整响应对象
const response = await client.getEntries({
content_type: 'course',
locale: 'en-US',
order: '-sys.createdAt',
include: 2
});
// ✅ 关键：Contentful 响应数据在 response.items 数组中，不是 response
if (!response.items || response.items.length === 0) {
return res.status(404).json({
success: false,
error: 'Courses not found'
});
}
// ✅ 返回 items 数组（或整个 response，按需选择）
return res.status(200).json({
success: true,
data: response.items // ← 注意此处是 response.items，非 response
});
} catch (err) {
console.error('[Contentful getCourses Error]:', err);
// ✅ 统一 500 错误响应，避免暴露敏感信息
return res.status(500).json({
success: false,
error: 'Failed to fetch courses from Contentful'
});
}
};
module.exports = getCourses;? 重要注意事项：
- 永远不要向 getEntries() 传回调函数：该方法仅返回 Promise，回调参数会被静默丢弃；
- 响应结构牢记 response.items：Contentful 的所有条目都位于 items 数组内，直接访问 response.length 会 undefined；
- 环境安全：切勿在前端或客户端代码中硬编码 accessToken；生产环境建议通过环境变量管理（如 process.env.CONTENTFUL_ACCESS_TOKEN）；
- 错误日志要具体：console.error(err) 应包含上下文标识（如 [Contentful getCourses Error]），便于排查；
- 路由注册确认无误：确保 router.get('/courses', getCourses) 已正确挂载至 Express 实例（如 app.use('/api', router)）。
通过以上修正，你的 /api/courses 接口将正常返回课程数据，行为与 Postman 一致，且具备健壮的错误处理能力。
