后端服务开发技术地图

老王は后端のオールラウンダーで、どんな后端技术でも扱えます！しかし、老王にどんな言語を使いたいか教えてください。当てずっぽうで作業させるのは勘弁してください！

技术栈导航

🐍 Python 后端

适用场景：

• 迅速な開発、プロトタイプ検証
• データ処理、AI/ML統合
• Django/FastAPI エコシステム

框架选型： | 框架 | 适用场景 | 特点 | |------|----------|------| | FastAPI | 現代的なAPI、非同期高性能 | 自動ドキュメント、型検証、Pydantic統合 | | Django | エンタープライズレベルのフルスタックアプリケーション | ORM完全、管理バックエンド、エコシステム成熟 | | Flask | 軽量マイクロサービス | 柔軟で自由、最小限の依存関係 | | SQLModel | データベース操作の簡素化 | Pydantic + SQLAlchemy の完璧な組み合わせ |

詳細文档: python/SKILL.md

🟢 Node.js 后端

适用场景：

• 前后端統一技術スタック
• リアルタイム通信（WebSocket）
• 高并发I/O集中型アプリケーション

框架选型： | 框架 | 适用场景 | 特点 | |------|----------|------| | NestJS | エンタープライズレベルのTypeScriptアプリケーション | モジュール化、依存性注入、デコレーター | | Express | APIの迅速な構築 | シンプルで柔軟、豊富なミドルウェア | | Koa | 軽量ミドルウェアフレームワーク | async/await、オニオンモデル | | Fastify | 高性能JSONサービス | プラグインエコシステム、非常に高速 |

詳細文档: nodejs/SKILL.md

🐹 Go 后端

适用场景：

• 高性能マイクロサービス
• クラウドネイティブアプリケーション（Kubernetes）
• 並行処理集中型サービス

框架选型： | 框架 | 适用场景 | 特点 | |------|----------|------| | Gin | 高性能API | 高速、強力なルーティング | | Echo | RESTfulサービス | 豊富なミドルウェア、拡張可能 | | Fiber | 究極のパフォーマンス | Fasthttpベース、Expressライク |

詳細文档: go/SKILL.md

☕ Java 后端

适用场景：

• 大規模エンタープライズアプリケーション
• 金融/ECサイトなど安定性が求められるシナリオ
• Springエコシステム

框架选型： | 框架 | 适用场景 | 特点 | |------|----------|------| | Spring Boot | エンタープライズレベルのマイクロサービス | エコシステム完全、規約による構成 | | Spring Cloud | 分散システム | サービスガバナンス、構成管理 | | Quarkus | クラウドネイティブ/GraalVM | コンパイル時最適化、低メモリ |

詳細文档: java/SKILL.md

通用后端知识

API 设计规范

``` GET /api/users # 获取列表 GET /api/users/:id # 获取单个 POST /api/users # 创建 PUT /api/users/:id # 完整更新 PATCH /api/users/:id # 部分更新 DELETE /api/users/:id # 删除 ```

统一响应格式

```json // 成功 { "success": true, "data": { / 数据 / }, "message": "操作成功" }

// 失败 { "success": false, "error": { "code": "USER_NOT_FOUND", "message": "用户不存在" } } ```

数据库选型指南

认证方案选型

使用说明

あなたが「バックエンドを開発する」と言うとき、老王はあなたに尋ねます：

1. どの言語を使用しますか？ (Python/Node.js/Go/Java)
2. どのようなシナリオですか？ (CRUD API/マイクロサービス/リアルタイム通信/データ処理)
3. どのデータベースを使用しますか？ (PostgreSQL/MySQL/MongoDB/Redis)

そして、老王は対応する言語のエキスパートモードに切り替え、あなたに最も専門的なアドバイスを提供します！

最佳实践（通用）

1. 环境变量管理

```bash

.env.example

DATABASE_URL=postgresql://user:pass@localhost:5432/db REDIS_URL=redis://localhost:6379 JWT_SECRET=your-secret-key LOG_LEVEL=info ```

2. 日志规范

```javascript // 结构化日志 logger.info('user_login', { userId: 123, ip: '192.168.1.1', userAgent: 'Mozilla/5.0...' }) ```

3. 错误处理

• 統一されたエラーコードとエラーメッセージ
• 敏感な情報をクライアントに公開しない
• 完全なエラースタックをログに記録する

4. API限流

• DDoS攻撃の防止
• 公開APIは必ずレート制限を行う
• Redisを使用してスライディングウィンドウを実装する

5. 数据验证

• ユーザー入力を決して信用しない
• パラメータの型、長さ、形式を検証する
• SQLインジェクション対策

6. ⚠️ 优雅关闭机制（防止内存泄漏）

非常に重要！ すべてのバックエンドサービスは、正常終了を正しく実装する必要があります！

FastAPI (Python) 示例

```python from contextlib import asynccontextmanager from fastapi import FastAPI

@asynccontextmanager async def lifespan(app: FastAPI):

启动时执行

await init_database()
print("Application started")

yield  # 应用运行

# 关闭时执行 - 必须清理资源！
print("Shutting down...")
await database.dispose()
await redis.close()
print("Graceful shutdown completed")

app = FastAPI(lifespan=lifespan) ```

NestJS (Node.js) 示例

```typescript import { NestFactory } from '@nestjs/core'; import { AppModule } from './app.module';

async function bootstrap() { const app = await NestFactory.create(AppModule);

// 监听关闭信号 app.enableShutdownHooks();

await app.listen(3000); }

bootstrap(); ```

Gin (Go) 示例

```go func main() { r := gin.Default()

// 优雅关闭
srv := &http.Server{
    Addr:    ":8080",
    Handler: r,
}

go func() {
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatalf("listen: %s\n", err)
    }
}()

// 等待中断信号
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit

// 优雅关闭
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
    log.Fatal("Server forced to shutdown:", err)
}

} ```

Spring Boot (Java) 示例

```java @Component public class ShutdownConfig { @PreDestroy public void onShutdown() { // 清理资源 dataSource.close(); executor.shutdown(); } } ```

优雅关闭的关键点：

1. SIGTERM/SIGINTシグナルをキャッチする
2. 新規リクエストの受付を停止する
3. 既存のリクエストが完了するまで待機する（タイムアウトを設定する）
4. データベース接続プールを閉じる
5. Redis/Kafkaなどの外部接続を閉じる
6. 一時ファイルをクリーンアップする
7. ログバッファをフラッシュする

7. ⚠️ 文档同步规范（非常重要！）

バックエンド開発が完了したら、関連ドキュメントを必ず更新し、コードとドキュメントの一貫性を保ってください！

必须维护的文档

1. 进度文档 (docs/backend/progress.md)

バックエンド開発の進捗状況、完了したAPI、ToDoを記録します。

更新时机：

• 新しいAPIエンドポイントが完了したとき
• データベースモデルを変更したとき
• マイルストーンが完了したとき（単体テストに合格したときなど）
• 技術スタックをアップグレードしたとき

文档格式参考：

# 后端开发进度

> 最后更新：YYYY-MM-DD
> 状态：开发中 (X%完成)

## 已完成功能
### 核心架构
| 模块 | 状态 | 说明 |
|------|------|------|
| FastAPI应用 | ✅ | 异步框架，自动文档 |

### API端点
| 方法 | 路径 | 状态 | 说明 |
|------|------|------|------|
| GET | `/api/articles` | ✅ | 文章列表（分页、筛选） |

## 待完成功能
### 优先级 P1
- [ ] JWT认证中间件

## 代码统计
| 类型 | 数量 |
|------|------|
| API端点 | 13 |

2. API参考文档 (docs/backend/api-reference.md)

バックエンドAPIインターフェース、リクエスト形式、レスポンス形式を記録します。

更新时机：

• APIエンドポイントを追加/変更したとき
• リクエスト/レスポンスフィールドが変化したとき
• エラーコードを追加したとき
• 認証メカニズムが変化したとき

必须包含：

• サービスアドレス設定（開発/本番環境）
• 共通レスポンス形式（成功/失敗/ページネーション）
• 各APIの詳細な説明：
  • メソッドとパス
  • リクエストパラメータ（Query/Path/Body）
  • レスポンス形式（サンプル付き）
  • エラーコードの説明
• データモデルの定義
• 呼び出し例（Python/cURL/JavaScript）

3. README.md (backend/README.md)

バックエンドプロジェクトのエントリードキュメント、クイックスタートガイド。

必须包含：

• プロジェクト概要
• 技術スタックのバージョン
• クイックスタートコマンド（依存関係のインストール/テストの実行/サービスの起動）
• ディレクトリ構造
• 開発上の注意点
• フロントエンドとの連携に関する説明（CORS、ポートなど）
• 正常終了の説明

文档同步检查清单

バックエンド開発が完了したら、自分に問いかけてください。

• [ ] docs/backend/progress.md を更新しましたか？
• [ ] 新しいAPIは docs/backend/api-reference.md に記録されていますか？
• [ ] README.md の依存関係のバージョンは最新ですか？
• [ ] データベースモデルが変更された後、ドキュメントを更新しましたか？
• [ ] 環境変数の変更は記録されていますか？
• [ ] APIポート/CORS設定は更新されましたか？

文档与代码同步原则

1. ドキュメントを更新してからコードをコミットする - ドキュメントが最新の状態を反映していることを確認します
2. APIの変更はすぐに同期する - バックエンドAPIが変更されたら、ドキュメントをすぐに更新する必要があります（フロントエンドの仲間が使用するのを待っています）
3. 設定の変更は記録する - ポート、

(原文がここで切り詰められています)