本文介绍如何使用 express 构建 restful get 接口，通过 url 路径参数（如 `/user/5`）动态查询单个用户，并在浏览器中直接访问返回结构化用户信息。
要实现类似 http://localhost:3000/user/5 这样的浏览器可访问 URL 并返回格式清晰的用户详情（例如 “User id: 5 Name: Ann”），你需要完成前后端协同配置：后端定义带路径参数的 GET 路由，正确解析 ID、查询数据库并响应；前端（浏览器）仅需输入 URL 即可触发请求。
✅ 后端实现（Express + MongoDB 示例）
假设你已搭建 Express 应用并连接 MongoDB（使用 Mongoose），推荐按以下方式定义路由：
// routes/userRoutes.js
const express = require('express');
const router = express.Router();
const User = require('../models/User'); // 假设你的用户模型名为 User
router.get('/user/:id', async (req, res) => {
try {
const { id } = req.params;
// 校验 ID 格式（防止无效 ObjectId）
if (!mongoose.Types.ObjectId.isValid(id)) {
return res.status(400).send('Invalid user ID format');
}
const user = await User.findById(id).select('name email _id'); // 按需投影字段
if (!user) {
return res.status(404).send('User not found');
}
// 返回简洁易读的 HTML 片段（适配浏览器直接查看）
res.send(`
<h2>User details</h2>
<p>User id: ${user._id}</p>
<p>Name: ${user.name || 'N/A'}</p>
<p>Email: ${user.email || 'N/A'}</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力：
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面；
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”；
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
`);
} catch (err) {
console.error(err);
res.status(500).send('Internal Server Error');
}
});
module.exports = router;并在主应用文件中挂载该路由：
// app.js
const userRoutes = require('./routes/userRoutes');
app.use('/', userRoutes); // 访问 /user/5 即可触发? 提示：若希望返回 JSON（更符合 REST 规范，便于前端 JS 消费），可将 res.send(...) 替换为：res.json({ id: user._id, name: user.name, email: user.email });此时浏览器会显示纯 JSON，而前端可通过 fetch('/user/5') 在 JavaScript 中解析。
⚠️ 注意事项
- 路径参数命名一致性：URL 中是 /user/5，则路由必须写为 /user/:id（而非 /users/:id），否则无法匹配；
- ID 类型校验：MongoDB 的 _id 是 ObjectId，直接传字符串 ID 时务必用 mongoose.Types.ObjectId.isValid() 验证，避免因非法 ID 导致未捕获异常；
- 错误处理不可省略：findById() 在 ID 格式错误或不存在时可能返回 null 或抛错，必须显式处理 404 和 500 状态；
- 安全性提醒：生产环境请避免暴露敏感字段（如密码哈希），始终使用 .select() 或 .toJSON() 控制输出字段。
✅ 浏览器验证方式
启动服务后，在浏览器地址栏输入：
http://localhost:3000/user/64a1b2c3d4e5f67890123456
（替换为你数据库中真实存在的用户 ObjectId）
即可看到渲染后的用户信息页面——无需额外前端代码，开箱即用。
通过这一模式，你不仅实现了资源导向的 API 设计，也为后续集成前端框架（React/Vue）或移动端调用打下坚实基础。
