refactor: 引入 apiHandler + ApiError，消除 20 个路由的 try/catch 样板

- 新增 src/lib/api.ts：ApiError 错误类 + apiHandler 统一包装器
- 20 个 API 路由统一使用 apiHandler，删除重复的 try/catch 块
- 验证错误改用 throw new ApiError()，减少嵌套层级
- join/manage 路由的错误码映射改为直接抛出 ApiError
- 删除已无引用的 errorResponse 辅助函数
- 净减 273 行代码

src/app/api/location/regeo/route.ts

@@ -1,54 +1,39 @@
 import { NextResponse } from "next/server";
+import { apiHandler, ApiError } from "@/lib/api";
 
-export async function GET(req: Request) {
-  const { searchParams } = new URL(req.url);
-  const lat = searchParams.get("lat");
-  const lng = searchParams.get("lng");
+export const GET = apiHandler(async (req) => {
+  const lat = req.nextUrl.searchParams.get("lat");
+  const lng = req.nextUrl.searchParams.get("lng");
 
-  if (!lat || !lng) {
-    return NextResponse.json(
-      { error: "lat and lng are required" },
-      { status: 400 },
-    );
-  }
+  if (!lat || !lng) throw new ApiError("lat and lng are required");
 
   const apiKey = process.env.AMAP_API_KEY;
-  if (!apiKey) {
-    return NextResponse.json(
-      { error: "AMAP_API_KEY not configured" },
-      { status: 500 },
-    );
-  }
+  if (!apiKey) throw new ApiError("AMAP_API_KEY not configured", 500);
 
-  try {
-    const url = new URL("https://restapi.amap.com/v3/geocode/regeo");
-    url.searchParams.set("key", apiKey);
-    url.searchParams.set("location", `${lng},${lat}`);
-    url.searchParams.set("extensions", "base");
+  const url = new URL("https://restapi.amap.com/v3/geocode/regeo");
+  url.searchParams.set("key", apiKey);
+  url.searchParams.set("location", `${lng},${lat}`);
+  url.searchParams.set("extensions", "base");
 
-    const res = await fetch(url.toString());
-    const data = await res.json();
+  const res = await fetch(url.toString());
+  const data = await res.json();
 
-    if (data.status !== "1" || !data.regeocode) {
-      return NextResponse.json({ name: null });
-    }
-
-    const comp = data.regeocode.addressComponent;
-    const district = comp?.district || comp?.city || "";
-    const township = comp?.township || "";
-    const neighborhood = comp?.neighborhood?.name || "";
-
-    const name = [district, township, neighborhood]
-      .filter(Boolean)
-      .join(" ")
-      .trim();
-
-    return NextResponse.json({
-      name: name || data.regeocode.formatted_address || null,
-      formatted: data.regeocode.formatted_address || null,
-    });
-  } catch (e) {
-    console.error("Regeo error:", e);
+  if (data.status !== "1" || !data.regeocode) {
     return NextResponse.json({ name: null });
   }
-}
+
+  const comp = data.regeocode.addressComponent;
+  const district = comp?.district || comp?.city || "";
+  const township = comp?.township || "";
+  const neighborhood = comp?.neighborhood?.name || "";
+
+  const name = [district, township, neighborhood]
+    .filter(Boolean)
+    .join(" ")
+    .trim();
+
+  return NextResponse.json({
+    name: name || data.regeocode.formatted_address || null,
+    formatted: data.regeocode.formatted_address || null,
+  });
+});