5.2 后端服务开发与部署

mkdir my-api-server
cd my-api-server
npm init -y

npm install express

// 引入 Express
const express = require('express');
const app = express();
 
// 设置端口
const PORT = 3000;
 
// 允许解析 JSON 请求体
app.use(express.json());
 
// 定义第一个路由
app.get('/', (req, res) => {
  res.json({
    message: 'Hello World! 这是我的第一个API服务器',
    timestamp: new Date().toISOString()
  });
});
 
// 启动服务器
app.listen(PORT, () => {
  console.log(`服务器运行在 http://localhost:${PORT}`);
});

node server.js

{
  "message": "Hello World! 这是我的第一个API服务器",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

const express = require('express');
const app = express();
const PORT = 3000;
 
// 中间件
app.use(express.json());
 
// 模拟数据库（实际项目中应该用真实数据库）
let todos = [
  { id: 1, title: '学习 Node.js', completed: false },
  { id: 2, title: '开发 API', completed: false }
];
let nextId = 3;
 
// ===== 1. 获取所有待办事项 =====
app.get('/api/todos', (req, res) => {
  res.json({
    success: true,
    data: todos
  });
});
 
// ===== 2. 获取单个待办事项 =====
app.get('/api/todos/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const todo = todos.find(t => t.id === id);
 
  if (!todo) {
    return res.status(404).json({
      success: false,
      message: '待办事项不存在'
    });
  }
 
  res.json({
    success: true,
    data: todo
  });
});
 
// ===== 3. 创建新待办事项 =====
app.post('/api/todos', (req, res) => {
  const { title } = req.body;
 
  // 验证
  if (!title || title.trim() === '') {
    return res.status(400).json({
      success: false,
      message: '标题不能为空'
    });
  }
 
  // 创建
  const newTodo = {
    id: nextId++,
    title: title.trim(),
    completed: false
  };
 
  todos.push(newTodo);
 
  res.status(201).json({
    success: true,
    data: newTodo
  });
});
 
// ===== 4. 更新待办事项 =====
app.patch('/api/todos/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const { title, completed } = req.body;
 
  const todo = todos.find(t => t.id === id);
 
  if (!todo) {
    return res.status(404).json({
      success: false,
      message: '待办事项不存在'
    });
  }
 
  // 更新
  if (title !== undefined) {
    todo.title = title.trim();
  }
  if (completed !== undefined) {
    todo.completed = completed;
  }
 
  res.json({
    success: true,
    data: todo
  });
});
 
// ===== 5. 删除待办事项 =====
app.delete('/api/todos/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const index = todos.findIndex(t => t.id === id);
 
  if (index === -1) {
    return res.status(404).json({
      success: false,
      message: '待办事项不存在'
    });
  }
 
  todos.splice(index, 1);
 
  res.json({
    success: true,
    message: '删除成功'
  });
});
 
// 启动服务器
app.listen(PORT, () => {
  console.log(`Todo API 服务器运行在 http://localhost:${PORT}`);
});

# 1. 获取所有待办
curl http://localhost:3000/api/todos
 
# 2. 创建新待办
curl -X POST http://localhost:3000/api/todos \
  -H "Content-Type: application/json" \
  -d '{"title":"学习Express"}'
 
# 3. 更新待办（标记完成）
curl -X PATCH http://localhost:3000/api/todos/1 \
  -H "Content-Type: application/json" \
  -d '{"completed":true}'
 
# 4. 删除待办
curl -X DELETE http://localhost:3000/api/todos/1

npm install dotenv

# .env
PORT=3000
DATABASE_URL=postgresql://user:password@localhost:5432/mydb
API_KEY=sk_test_1234567890abcdef
NODE_ENV=development

// server.js
require('dotenv').config();
 
const PORT = process.env.PORT || 3000;
const API_KEY = process.env.API_KEY;
 
console.log('API Key:', API_KEY); // 只在开发时打印，生产环境删除
 
app.listen(PORT, () => {
  console.log(`服务器运行在端口 ${PORT}`);
});

# .gitignore
.env
node_modules/

# .env.example
PORT=3000
DATABASE_URL=your_database_url
API_KEY=your_api_key
NODE_ENV=development

// 错误处理中间件（放在所有路由之后）
app.use((err, req, res, next) => {
  console.error('错误详情:', err);
 
  res.status(err.status || 500).json({
    success: false,
    message: err.message || '服务器内部错误',
    // 开发环境返回错误堆栈，生产环境不返回
    ...(process.env.NODE_ENV === 'development' && { stack: err.stack })
  });
});

// 404 处理（放在所有路由之后，错误处理之前）
app.use((req, res) => {
  res.status(404).json({
    success: false,
    message: '接口不存在'
  });
});

// 封装异步路由处理器
const asyncHandler = (fn) => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};
 
// 使用
app.get('/api/users', asyncHandler(async (req, res) => {
  // 如果这里抛出错误，会自动被错误处理中间件捕获
  const users = await getUsersFromDatabase();
  res.json({ success: true, data: users });
}));

run = "node server.js"

https://my-api-server.username.repl.co