first commit

app/Exception/BusinessException.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  group@hyperf.io
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+
+namespace App\Exception;
+
+use App\Constants\ErrorCode;
+use Hyperf\Server\Exception\ServerException;
+use Throwable;
+
+class BusinessException extends ServerException
+{
+    public function __construct(int $code = 0, string $message = null, Throwable $previous = null)
+    {
+        if (is_null($message)) {
+            $message = ErrorCode::getMessage($code);
+        }
+
+        parent::__construct($message, $code, $previous);
+    }
+}

app/Exception/ErrException.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Exception;
+
+use App\Constants\ResultCode;
+use Hyperf\Server\Exception\ServerException;
+
+class ErrException extends ServerException
+{
+    /**
+     * @var int
+     */
+    protected $code = ResultCode::ERROR;
+}

app/Exception/Handler/AppExceptionHandler.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  group@hyperf.io
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+
+namespace App\Exception\Handler;
+
+use Hyperf\Contract\StdoutLoggerInterface;
+use Hyperf\ExceptionHandler\ExceptionHandler;
+use Hyperf\HttpMessage\Stream\SwooleStream;
+use Psr\Http\Message\ResponseInterface;
+use Throwable;
+
+class AppExceptionHandler extends ExceptionHandler
+{
+    public function __construct(protected StdoutLoggerInterface $logger)
+    {
+    }
+
+    public function handle(Throwable $throwable, ResponseInterface $response)
+    {
+        $this->logger->error(sprintf('%s[%s] in %s', $throwable->getMessage(), $throwable->getLine(), $throwable->getFile()));
+        $this->logger->error($throwable->getTraceAsString());
+        return $response->withHeader('Server', 'Hyperf')->withStatus(500)->withBody(new SwooleStream('Internal Server Error.'));
+    }
+
+    public function isValid(Throwable $throwable): bool
+    {
+        return true;
+    }
+}

app/Exception/Handler/BaseErrExceptionHandler.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Exception\Handler;
+
+
+use App\Lib\Return\AdminReturn;
+use App\Lib\Return\ApiReturn;
+use Hyperf\ExceptionHandler\ExceptionHandler;
+use Hyperf\HttpMessage\Stream\SwooleStream;
+use Hyperf\HttpServer\Request;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\ContainerInterface;
+use Psr\Container\NotFoundExceptionInterface;
+use Psr\Http\Message\MessageInterface;
+use Psr\Http\Message\ResponseInterface;
+use Throwable;
+
+abstract class BaseErrExceptionHandler extends ExceptionHandler
+{
+   public function __construct(
+       private readonly Request $request,
+       private readonly ContainerInterface $container,
+   ) {}
+
+    /**
+     * @param Throwable $e
+     * @param ResponseInterface $response
+     * @return MessageInterface|ResponseInterface
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     */
+    protected function handlerResponse(
+        Throwable $e,
+        ResponseInterface $response
+    ): MessageInterface|ResponseInterface
+    {
+        //  从注解获取响应格式（优先于路径解析）
+        $format = $this->request->getAttribute('response_format') ?? $this->repairResponseFormatByPath();
+
+        //  动态选择策略
+        $returnClass = match ($format) {
+            'admin', 'common' => AdminReturn::class,
+            'api' => ApiReturn::class,
+            default => null,
+        };
+        if (!$returnClass) return $response;
+
+        /**
+         * @var AdminReturn|ApiReturn $returnObj
+         */
+        $returnObj = $this->container->get($returnClass);
+        $result = $returnObj->error($e->getMessage(), $e->getCode());
+        $this->stopPropagation();
+        return $response->withHeader("Content-Type", "application/json")
+            ->withStatus(200)
+            ->withBody(new SwooleStream(json_encode($result, JSON_UNESCAPED_UNICODE)));
+    }
+
+    /**
+     * @return string
+     */
+    private function repairResponseFormatByPath(): string
+    {
+        // 兜底逻辑：根据路径前缀推断
+        return match (explode('/', $this->request->path())[0] ?? '') {
+            'admin', 'common' => 'admin',
+            'api' => 'api',
+            default => 'default',
+        };
+    }
+}

app/Exception/Handler/ErrExceptionHandler.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Exception\Handler;
+
+use App\Exception\ErrException;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\NotFoundExceptionInterface;
+use Psr\Http\Message\ResponseInterface;
+use Throwable;
+
+class ErrExceptionHandler extends BaseErrExceptionHandler
+{
+    /**
+     * @param Throwable $throwable
+     * @param ResponseInterface $response
+     * @return ResponseInterface
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     */
+    public function handle(Throwable $throwable, ResponseInterface $response): ResponseInterface
+    {
+        return $throwable instanceof ErrException
+            ? $this->handlerResponse($throwable, $response)
+            : $response;
+    }
+
+    /**
+     * @param Throwable $throwable
+     * @return bool
+     */
+    public function isValid(Throwable $throwable): bool
+    {
+        return $throwable instanceof ErrException;
+    }
+}

app/Exception/Handler/ValidationExceptionHandler.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Exception\Handler;
+
+use Hyperf\Validation\ValidationException;
+use Psr\Container\ContainerExceptionInterface;
+use Psr\Container\NotFoundExceptionInterface;
+use Psr\Http\Message\ResponseInterface;
+use Throwable;
+
+class ValidationExceptionHandler extends BaseErrExceptionHandler
+{
+    /**
+     * @param Throwable $throwable
+     * @param ResponseInterface $response
+     * @return ResponseInterface
+     * @throws ContainerExceptionInterface
+     * @throws NotFoundExceptionInterface
+     */
+    public function handle(Throwable $throwable, ResponseInterface $response): ResponseInterface
+    {
+        return $throwable instanceof ValidationException
+            ? $this->handlerResponse($throwable, $response)
+            : $response;
+    }
+
+    /**
+     * @param Throwable $throwable
+     * @return bool
+     */
+    public function isValid(Throwable $throwable): bool
+    {
+        return $throwable instanceof ValidationException;
+    }
+}