feat(address): 添加地址解析功能

- 新增 /address/parse API 接口用于地址解析
- 配置阿里云市场地址解析服务参数
- 实现地址解析控制器方法
- 添加地址解析仓库逻辑和异常处理
- 集成 HttpService 进行第三方 API 调用
- 添加详细的日志记录和错误处理机制

app/common/repositories/user/UserAddressRepository.php

@@ -11,6 +11,8 @@ use app\common\repositories\BaseRepository;
 use app\common\dao\user\UserAddressDao as dao;
 use app\common\repositories\store\shipping\CityRepository;
 use app\entity\data\user\UserAddressEntity;
+use crmeb\services\HttpService;
+use think\facade\Log;
 
 /**
  * Class UserAddressRepository
@@ -136,4 +138,63 @@ class UserAddressRepository extends BaseRepository
         $addressEntity = $this->dao->getAddressEntityByAddressId($addressId);
         return $addressEntity;
     }
+
+    /**
+     * 阿里云市场 - 地址解析
+     *
+     * 调用阿里云市场地址解析接口，将完整的地址文本解析为省/市/区/街道等结构化信息
+     *
+     * 接口文档: https://market.aliyun.com/detail/cmapi00067026
+     * 请求方式: GET
+     * 认证方式: Authorization:APPCODE
+     *
+     * @param string $address 待解析的地址文本，如 "北京市朝阳区建国路88号SOHO现代城A座1508室"
+     * @return array 统一返回格式：
+     *               成功 {"code":200,"msg":"成功","data":{...}}
+     *               失败 {"code":-1,"msg":"错误信息","data":[]}
+     */
+    public function parse($address)
+    {
+        $config = config('third_party.aliyun_address_parse');
+        $appCode = $config['appCode'] ?? '';
+
+        if (empty($appCode)) {
+            $msg = '地址解析失败：未配置阿里云市场 AppCode';
+            Log::error($msg);
+            return ['code' => -1, 'msg' => $msg, 'data' => []];
+        }
+
+        if (empty($address)) {
+            $msg = '地址解析失败：地址文本为空';
+            Log::error($msg);
+            return ['code' => -2, 'msg' => $msg, 'data' => []];
+        }
+
+        $url = rtrim($config['gatewayUrl'] ?? 'https://kzaddress2.market.alicloudapi.com', '/')
+             . ($config['apiPath'] ?? '/api/address/parse');
+
+        $header = ['Authorization:APPCODE ' . $appCode];
+
+        try {
+            $res = HttpService::getRequest($url, ['address' => $address], $header);
+            if ($res === false) {
+                $msg = '地址解析请求失败';
+                Log::error($msg . '：' . $url . '，地址：' . $address);
+                return ['code' => -3, 'msg' => $msg, 'data' => []];
+            }
+
+            $result = json_decode($res, true);
+            if (json_last_error() !== JSON_ERROR_NONE) {
+                $msg = '地址解析返回数据解析失败：' . json_last_error_msg();
+                Log::error($msg . '，原始数据：' . $res);
+                return ['code' => -4, 'msg' => $msg, 'data' => []];
+            }
+
+            return ['code' => 200, 'msg' => '成功', 'data' => $result];
+        } catch (\Throwable $e) {
+            $msg = '地址解析异常：' . $e->getMessage();
+            Log::error($msg . '，文件：' . $e->getFile() . '，行号：' . $e->getLine());
+            return ['code' => -5, 'msg' => $msg, 'data' => []];
+        }
+    }
 }

app/controller/api/user/UserAddress.php

@@ -133,6 +133,22 @@ class UserAddress extends BaseController
     }
 
     /**
+     * @return mixed
+     * @author 史晨
+     * @date 2026/5/15 10:04
+     * 地址解析
+     */
+    public function parse()
+    {
+        $address = $this->request->param('address');
+        $res = $this->repository->parse($address);
+        if ($res['code'] != 200) {
+            return app('json')->fail($res['msg']);
+        }
+        return app('json')->success($res['data']);
+    }
+
+    /**
      * @param validate $validate
      * @return array
      * @author Qinii

config/third_party.php

@@ -26,5 +26,14 @@ return [
         'logEnabled' => true,
         // 日志目录
         'logPath' => runtime_path() . 'alibaba/',
+    ],
+    // 阿里云市场 - 地址解析
+    'aliyun_address_parse' => [
+        // 阿里云市场 AppCode（从阿里云市场控制台获取）
+        'appCode' => '10e4d1cae6c245049d0ec51bc079a3d6',
+        // API 网关地址
+        'gatewayUrl' => 'https://kzaddress2.market.alicloudapi.com',
+        // API 路径
+        'apiPath' => '/api/address/parse',
     ]
 ];

route/api.php

@@ -218,6 +218,8 @@ Route::group('api/', function () {
             Route::get('/address/detail/:id', 'UserAddress/detail');
             Route::post('/address/update/:id', 'UserAddress/editDefault');
             Route::post('/address/delete/:id', 'UserAddress/delete');
+            // 地址解析
+            Route::get('/address/parse', 'UserAddress/parse');
 
             //分销海报
             Route::get('/spread_image', 'User/spread_image');