diff --git a/COROUTINE_FIX.md b/COROUTINE_FIX.md
new file mode 100644
index 0000000..3b5ce0c
--- /dev/null
+++ b/COROUTINE_FIX.md
@@ -0,0 +1,198 @@
+# Fix: Coroutine Stream Response Exception
+
+## Problem
+
+When executing stream responses in Hyperf's coroutine environment (e.g., Command with `$coroutine = true`), the application encounters "Connection refused" errors for HTTPS connections, even though the same code works perfectly in non-coroutine contexts (single-file mode).
+
+### Error Example
+```
+LLM网络连接错误: Connection refused for URI https://one-api.system.xxx.com/v1/chat/completions
+```
+
+### Root Cause
+
+According to the issue author (@huangdijia), the problem is related to the OpenSSL version that Swoole was compiled with. When Swoole is compiled with an older OpenSSL version, the cURL handler may not properly handle HTTPS connections within coroutine contexts, leading to connection failures.
+
+## Solution
+
+The fix automatically detects when code is running in a coroutine context and switches to PHP's stream handler, which:
+- Is a pure PHP implementation
+- Does not depend on Swoole's SSL/OpenSSL implementation
+- Works reliably in both coroutine and non-coroutine contexts
+
+## Implementation Details
+
+### 1. Coroutine Detection
+
+Added `isInCoroutineContext()` method to `HttpHandlerFactory` that detects:
+- `Swoole\Coroutine` - Direct Swoole coroutine detection
+- `Hyperf\Engine\Coroutine` - Hyperf's abstraction layer (supports both Swoole and Swow)
+
+```php
+public static function isInCoroutineContext(): bool
+{
+    // Check Swoole coroutine
+    if (class_exists(\Swoole\Coroutine::class, false)) {
+        try {
+            $cid = \Swoole\Coroutine::getCid();
+            return $cid > 0;  // > 0 means in coroutine
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    // Check Hyperf Engine coroutine
+    if (class_exists(\Hyperf\Engine\Coroutine::class, false)) {
+        try {
+            $id = \Hyperf\Engine\Coroutine::id();
+            return $id > 0;
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    return false;
+}
+```
+
+### 2. Automatic Handler Switching
+
+Modified `create()` method to automatically use stream handler in coroutine contexts:
+
+```php
+public static function create(string $type = 'auto'): callable
+{
+    // Automatically use stream handler in coroutine context to avoid OpenSSL compatibility issues
+    if ($type === 'auto' && self::isInCoroutineContext()) {
+        return self::createStreamHandler();
+    }
+
+    return match (strtolower($type)) {
+        'stream' => self::createStreamHandler(),
+        'auto' => self::createAutoHandler(),
+        default => self::createCurlHandler(),
+    };
+}
+```
+
+### 3. Updated Recommendations
+
+Modified `getRecommendedHandler()` to recommend stream handler in coroutine contexts:
+
+```php
+public static function getRecommendedHandler(): string
+{
+    // Recommend stream handler in coroutine context
+    if (self::isInCoroutineContext()) {
+        return 'stream';
+    }
+
+    if (function_exists('curl_multi_exec') && function_exists('curl_exec')) {
+        return 'curl';
+    }
+
+    if (ini_get('allow_url_fopen')) {
+        return 'stream';
+    }
+
+    return 'auto';
+}
+```
+
+## Usage
+
+### Automatic (Recommended)
+
+No code changes required! The framework automatically detects coroutine context and uses the appropriate handler:
+
+```php
+$model = new DoubaoModel(
+    'deepseek-r1-250120',
+    [
+        'api_key' => 'sk-xxx',
+        'base_url' => 'https://api.example.com/v1',
+    ],
+    new Logger(),
+);
+
+// In coroutine context: automatically uses stream handler
+// In non-coroutine context: uses default Guzzle selection
+```
+
+### Explicit Configuration
+
+You can still explicitly specify the handler if needed:
+
+```php
+// Force stream handler
+$model->setApiRequestOptions(new ApiOptions([
+    'http_handler' => 'stream',
+]));
+
+// Force cURL handler (not recommended in coroutine context)
+$model->setApiRequestOptions(new ApiOptions([
+    'http_handler' => 'curl',
+]));
+```
+
+### Environment Variable
+
+Set globally via environment variable:
+```env
+ODIN_HTTP_HANDLER=stream
+```
+
+### Configuration File
+
+Configure per model in `config/autoload/odin.php`:
+```php
+return [
+    'models' => [
+        'deepseek-r1' => [
+            // ...
+            'api_options' => [
+                'http_handler' => 'stream',
+            ],
+        ],
+    ],
+];
+```
+
+## Testing
+
+### Unit Tests
+
+Added `HttpHandlerFactoryTest` with tests for:
+- Coroutine detection
+- Handler creation
+- Environment information
+- Handler availability
+
+### Manual Testing
+
+Created manual test script at `tests/manual/test_http_handler.php` that can be run:
+- In non-coroutine context: `php tests/manual/test_http_handler.php`
+- In coroutine context: Create a Hyperf command and run it
+
+## Benefits
+
+1. **Zero Configuration**: Works out of the box with no code changes
+2. **Backward Compatible**: Existing explicit configurations continue to work
+3. **Flexible**: Can still override with explicit handler selection
+4. **Reliable**: Stream handler is stable in both environments
+5. **Safe**: Uses try-catch blocks to handle detection failures gracefully
+
+## Documentation
+
+Updated documentation:
+- Chinese FAQ (`doc/user-guide-cn/10-faq.md`)
+- English FAQ (`doc/user-guide/10-faq.md`)
+- Example code comments (`examples/stream.php`)
+- Manual test README (`tests/manual/README.md`)
+
+## Compatibility
+
+- Works with Hyperf 2.2.x, 3.0.x, and 3.1.x
+- Supports both Swoole and Swow (via Hyperf Engine)
+- No breaking changes to existing API
+- PHP 8.1+ required (as per existing requirements)
diff --git a/FLOW_DIAGRAM.md b/FLOW_DIAGRAM.md
new file mode 100644
index 0000000..002ec0a
--- /dev/null
+++ b/FLOW_DIAGRAM.md
@@ -0,0 +1,140 @@
+# Coroutine Stream Response Fix - Visual Flow
+
+## Before the Fix
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Hyperf Command                            │
+│                  ($coroutine = true)                         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│              Model->chatStream($messages)                    │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         HttpHandlerFactory::create('auto')                   │
+│         Always uses: Guzzle's default handler (cURL)         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         cURL Handler in Coroutine Context                    │
+│         with old Swoole OpenSSL version                      │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+                        ❌ FAILS ❌
+              "Connection refused for URI"
+```
+
+## After the Fix
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Hyperf Command                            │
+│                  ($coroutine = true)                         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│              Model->chatStream($messages)                    │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         HttpHandlerFactory::create('auto')                   │
+│         ┌─────────────────────────────────────┐              │
+│         │ isInCoroutineContext()              │              │
+│         │   ✓ Swoole\Coroutine::getCid() > 0  │              │
+│         │     OR                               │              │
+│         │   ✓ Hyperf\Engine\Coroutine::id()>0 │              │
+│         └─────────────────────────────────────┘              │
+│         Decision: USE STREAM HANDLER                         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         Stream Handler (Pure PHP)                            │
+│         No cURL, No Swoole SSL dependency                    │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+                        ✅ SUCCESS ✅
+                 Stream Response Works!
+```
+
+## Non-Coroutine Context (Unchanged Behavior)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Single File Script                        │
+│                  (No coroutine)                              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│              Model->chatStream($messages)                    │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         HttpHandlerFactory::create('auto')                   │
+│         ┌─────────────────────────────────────┐              │
+│         │ isInCoroutineContext()              │              │
+│         │   ✗ Not in coroutine                │              │
+│         └─────────────────────────────────────┘              │
+│         Decision: USE DEFAULT (cURL preferred)               │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│         cURL Handler (Better Performance)                    │
+│         No coroutine context issues                          │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+                        ✅ SUCCESS ✅
+                 Stream Response Works!
+```
+
+## Key Detection Logic
+
+```php
+public static function isInCoroutineContext(): bool
+{
+    // Check Swoole coroutine
+    if (class_exists(\Swoole\Coroutine::class, false)) {
+        try {
+            $cid = \Swoole\Coroutine::getCid();
+            return $cid > 0;  // -1 or 0 = not in coroutine
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    // Check Hyperf Engine coroutine (Swoole/Swow)
+    if (class_exists(\Hyperf\Engine\Coroutine::class, false)) {
+        try {
+            $id = \Hyperf\Engine\Coroutine::id();
+            return $id > 0;
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    return false;
+}
+```
+
+## Handler Selection Matrix
+
+| Context        | Handler Type | Mode   | Result          |
+|----------------|--------------|--------|-----------------|
+| Coroutine      | auto         | ✅     | stream          |
+| Coroutine      | stream       | ✅     | stream          |
+| Coroutine      | curl         | ⚠️     | curl (explicit) |
+| Non-Coroutine  | auto         | ✅     | curl/auto       |
+| Non-Coroutine  | stream       | ✅     | stream          |
+| Non-Coroutine  | curl         | ✅     | curl            |
+
+✅ = Recommended/Safe
+⚠️ = Not recommended but allowed (user override)
+
+## Benefits Summary
+
+1. **Zero Configuration**: Automatically works in coroutine contexts
+2. **Performance**: Uses cURL in non-coroutine contexts for better performance
+3. **Compatibility**: Stream handler works with all OpenSSL versions
+4. **Flexibility**: Users can still override with explicit configuration
+5. **Safety**: Graceful fallback on detection errors
diff --git a/doc/user-guide-cn/10-faq.md b/doc/user-guide-cn/10-faq.md
index 1d013f7..fb62183 100644
--- a/doc/user-guide-cn/10-faq.md
+++ b/doc/user-guide-cn/10-faq.md
@@ -43,7 +43,60 @@ $model = ModelFactory::create(
 );
 ```
 
-### 2. 模型响应格式错误
+### 2. 协程环境下流式响应连接失败
+
+**问题**: 在 Hyperf 框架的协程环境中（如 Command 命令且 `$coroutine = true`），执行流式响应时出现 "Connection refused" 错误，但在非协程环境中正常工作。
+
+**原因**: 
+- Swoole 编译时使用的 OpenSSL 版本较旧，可能与 cURL 扩展在协程上下文中处理 HTTPS 连接时存在兼容性问题
+- cURL handler 在协程环境中可能无法正确处理 SSL/TLS 连接
+
+**解决方案**:
+
+从 Odin v1.x.x 版本开始，框架会**自动检测协程上下文**并切换到兼容的 HTTP 处理器。如果您遇到此问题：
+
+```php
+// 方案 1: 让框架自动处理（推荐）
+// 使用默认的 'auto' 配置，框架会自动检测协程环境并使用 stream 处理器
+$model = new DoubaoModel(
+    'deepseek-r1-250120',
+    [
+        'api_key' => 'sk-xxx',
+        'base_url' => 'https://api.example.com/v1',
+    ],
+    new Logger(),
+);
+// 在协程环境中会自动使用 stream 处理器
+
+// 方案 2: 显式指定使用 stream 处理器
+$model->setApiRequestOptions(new ApiOptions([
+    'http_handler' => 'stream',  // 强制使用 stream 处理器
+]));
+
+// 方案 3: 通过环境变量全局配置
+// 在 .env 中设置
+// ODIN_HTTP_HANDLER=stream
+
+// 方案 4: 在配置文件中设置（针对特定模型）
+// config/autoload/odin.php
+return [
+    'models' => [
+        'deepseek-r1' => [
+            // ...
+            'api_options' => [
+                'http_handler' => 'stream',
+            ],
+        ],
+    ],
+];
+```
+
+**注意事项**:
+- Stream 处理器是纯 PHP 实现，不依赖 cURL 扩展，在协程环境中更稳定
+- 自动检测机制会检测 `Swoole\Coroutine` 和 `Hyperf\Engine\Coroutine`
+- 如果需要在非协程环境中使用 stream 处理器，也可以显式指定
+
+### 3. 模型响应格式错误
 
 **问题**: 模型返回的响应格式与预期不符，导致解析错误。
 
@@ -69,7 +122,7 @@ try {
 }
 ```
 
-### 3. 工具调用失败
+### 4. 工具调用失败
 
 **问题**: 工具调用返回错误或未按预期执行。
 
@@ -109,7 +162,7 @@ try {
 }
 ```
 
-### 4. 内存溢出错误
+### 5. 内存溢出错误
 
 **问题**: 处理大量对话历史或大文档时出现内存溢出错误。
 
@@ -142,7 +195,7 @@ foreach ($batches as $batch) {
 }
 ```
 
-### 5. 授权和认证错误
+### 6. 授权和认证错误
 
 **问题**: 授权失败，无法访问 LLM 服务。
 
diff --git a/doc/user-guide/10-faq.md b/doc/user-guide/10-faq.md
index 6da9d0b..60e44dc 100644
--- a/doc/user-guide/10-faq.md
+++ b/doc/user-guide/10-faq.md
@@ -43,7 +43,60 @@ $model = ModelFactory::create(
 );
 ```
 
-### 2. 模型响应格式错误
+### 2. Stream Response Connection Failed in Coroutine Context
+
+**Problem**: When running in Hyperf framework's coroutine environment (such as Command with `$coroutine = true`), stream responses fail with "Connection refused" error, but work normally in non-coroutine context.
+
+**Causes**: 
+- Swoole compiled with an older OpenSSL version may have compatibility issues with cURL extension when handling HTTPS connections in coroutine context
+- cURL handler may not correctly handle SSL/TLS connections in coroutine environment
+
+**Solutions**:
+
+Starting from Odin v1.x.x, the framework **automatically detects coroutine context** and switches to a compatible HTTP handler. If you encounter this issue:
+
+```php
+// Solution 1: Let the framework handle automatically (Recommended)
+// Using default 'auto' configuration, framework will auto-detect coroutine and use stream handler
+$model = new DoubaoModel(
+    'deepseek-r1-250120',
+    [
+        'api_key' => 'sk-xxx',
+        'base_url' => 'https://api.example.com/v1',
+    ],
+    new Logger(),
+);
+// Will automatically use stream handler in coroutine context
+
+// Solution 2: Explicitly specify stream handler
+$model->setApiRequestOptions(new ApiOptions([
+    'http_handler' => 'stream',  // Force use of stream handler
+]));
+
+// Solution 3: Global configuration via environment variable
+// Set in .env file
+// ODIN_HTTP_HANDLER=stream
+
+// Solution 4: Set in configuration file (for specific models)
+// config/autoload/odin.php
+return [
+    'models' => [
+        'deepseek-r1' => [
+            // ...
+            'api_options' => [
+                'http_handler' => 'stream',
+            ],
+        ],
+    ],
+];
+```
+
+**Notes**:
+- Stream handler is a pure PHP implementation, does not depend on cURL extension, and is more stable in coroutine environments
+- Auto-detection mechanism checks for `Swoole\Coroutine` and `Hyperf\Engine\Coroutine`
+- You can also explicitly specify stream handler in non-coroutine environments if needed
+
+### 3. 模型响应格式错误
 
 **问题**: 模型返回的响应格式与预期不符，导致解析错误。
 
@@ -69,7 +122,7 @@ try {
 }
 ```
 
-### 3. 工具调用失败
+### 4. 工具调用失败
 
 **问题**: 工具调用返回错误或未按预期执行。
 
@@ -109,7 +162,7 @@ try {
 }
 ```
 
-### 4. 内存溢出错误
+### 5. 内存溢出错误
 
 **问题**: 处理大量对话历史或大文档时出现内存溢出错误。
 
@@ -142,7 +195,7 @@ foreach ($batches as $batch) {
 }
 ```
 
-### 5. 授权和认证错误
+### 6. 授权和认证错误
 
 **问题**: 授权失败，无法访问 LLM 服务。
 
diff --git a/examples/stream.php b/examples/stream.php
index 24881b1..a44b13c 100644
--- a/examples/stream.php
+++ b/examples/stream.php
@@ -41,6 +41,9 @@
 
 $model->setApiRequestOptions(new ApiOptions([
     // HTTP 处理器配置 - 支持环境变量 ODIN_HTTP_HANDLER
+    // 'auto': 自动选择（在协程环境中自动使用 stream 处理器）
+    // 'curl': 强制使用 cURL（推荐用于非协程环境）
+    // 'stream': 强制使用 PHP Stream（在协程环境中更稳定）
     'http_handler' => env('ODIN_HTTP_HANDLER', 'auto'),
 ]));
 
diff --git a/src/Api/Providers/HttpHandlerFactory.php b/src/Api/Providers/HttpHandlerFactory.php
index d996e94..2ba3560 100644
--- a/src/Api/Providers/HttpHandlerFactory.php
+++ b/src/Api/Providers/HttpHandlerFactory.php
@@ -34,6 +34,11 @@ class HttpHandlerFactory
      */
     public static function create(string $type = 'auto'): callable
     {
+        // 在协程上下文中自动使用 stream 处理器以避免 OpenSSL 兼容性问题
+        if ($type === 'auto' && self::isInCoroutineContext()) {
+            return self::createStreamHandler();
+        }
+
         return match (strtolower($type)) {
             'stream' => self::createStreamHandler(),
             'auto' => self::createAutoHandler(),
@@ -133,6 +138,7 @@ public static function getEnvironmentInfo(): array
             'curl_version' => function_exists('curl_version') ? curl_version() : null,
             'stream_available' => ini_get('allow_url_fopen') !== false,
             'openssl_available' => extension_loaded('openssl'),
+            'in_coroutine_context' => self::isInCoroutineContext(),
             'recommended_handler' => self::getRecommendedHandler(),
         ];
     }
@@ -144,6 +150,11 @@ public static function getEnvironmentInfo(): array
      */
     public static function getRecommendedHandler(): string
     {
+        // 在协程上下文中推荐使用 stream 处理器以避免 OpenSSL 兼容性问题
+        if (self::isInCoroutineContext()) {
+            return 'stream';
+        }
+
         if (function_exists('curl_multi_exec') && function_exists('curl_exec')) {
             return 'curl'; // Best performance for concurrent requests
         }
@@ -155,6 +166,38 @@ public static function getRecommendedHandler(): string
         return 'auto'; // Let Guzzle decide
     }
 
+    /**
+     * Check if the code is running in a coroutine context.
+     * 检测是否在协程上下文中运行
+     *
+     * @return bool True if running in a coroutine context
+     */
+    public static function isInCoroutineContext(): bool
+    {
+        // 检测 Swoole 协程
+        if (class_exists(\Swoole\Coroutine::class, false)) {
+            try {
+                $cid = \Swoole\Coroutine::getCid();
+                return $cid > 0;
+            } catch (\Throwable $e) {
+                // 如果调用失败，说明不在协程上下文中
+                return false;
+            }
+        }
+
+        // 检测 Hyperf Engine 协程（支持 Swoole 和 Swow）
+        if (class_exists(\Hyperf\Engine\Coroutine::class, false)) {
+            try {
+                $id = \Hyperf\Engine\Coroutine::id();
+                return $id > 0;
+            } catch (\Throwable $e) {
+                return false;
+            }
+        }
+
+        return false;
+    }
+
     /**
      * Create HTTP client options with proper handler configuration.
      *
diff --git a/tests/Cases/Api/Providers/HttpHandlerFactoryTest.php b/tests/Cases/Api/Providers/HttpHandlerFactoryTest.php
new file mode 100644
index 0000000..1fb9e6b
--- /dev/null
+++ b/tests/Cases/Api/Providers/HttpHandlerFactoryTest.php
@@ -0,0 +1,134 @@
+<?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 HyperfTest\Odin\Cases\Api\Providers;
+
+use GuzzleHttp\Handler\StreamHandler;
+use Hyperf\Odin\Api\Providers\HttpHandlerFactory;
+use HyperfTest\Odin\Cases\AbstractTestCase;
+
+/**
+ * @internal
+ * @covers \Hyperf\Odin\Api\Providers\HttpHandlerFactory
+ */
+class HttpHandlerFactoryTest extends AbstractTestCase
+{
+    /**
+     * 测试在非协程上下文中的 auto 模式.
+     */
+    public function testCreateAutoHandlerInNonCoroutineContext()
+    {
+        // 在非协程上下文中，应该使用默认的 auto 处理器
+        $handler = HttpHandlerFactory::create('auto');
+        $this->assertIsCallable($handler);
+    }
+
+    /**
+     * 测试显式创建 stream 处理器.
+     */
+    public function testCreateStreamHandler()
+    {
+        $handler = HttpHandlerFactory::createStreamHandler();
+        $this->assertInstanceOf(StreamHandler::class, $handler);
+    }
+
+    /**
+     * 测试显式创建 curl 处理器.
+     */
+    public function testCreateCurlHandler()
+    {
+        $handler = HttpHandlerFactory::createCurlHandler();
+        $this->assertIsCallable($handler);
+    }
+
+    /**
+     * 测试协程检测方法在非协程上下文中返回 false.
+     */
+    public function testIsInCoroutineContextReturnsFalseInNonCoroutineContext()
+    {
+        // 在测试环境中（非协程上下文），应该返回 false
+        $result = HttpHandlerFactory::isInCoroutineContext();
+        $this->assertFalse($result);
+    }
+
+    /**
+     * 测试环境信息获取.
+     */
+    public function testGetEnvironmentInfo()
+    {
+        $info = HttpHandlerFactory::getEnvironmentInfo();
+        
+        $this->assertIsArray($info);
+        $this->assertArrayHasKey('curl_available', $info);
+        $this->assertArrayHasKey('curl_multi_available', $info);
+        $this->assertArrayHasKey('stream_available', $info);
+        $this->assertArrayHasKey('openssl_available', $info);
+        $this->assertArrayHasKey('in_coroutine_context', $info);
+        $this->assertArrayHasKey('recommended_handler', $info);
+        
+        $this->assertIsBool($info['curl_available']);
+        $this->assertIsBool($info['curl_multi_available']);
+        $this->assertIsBool($info['stream_available']);
+        $this->assertIsBool($info['openssl_available']);
+        $this->assertIsBool($info['in_coroutine_context']);
+        $this->assertIsString($info['recommended_handler']);
+    }
+
+    /**
+     * 测试在非协程上下文中的推荐处理器.
+     */
+    public function testGetRecommendedHandlerInNonCoroutineContext()
+    {
+        $recommended = HttpHandlerFactory::getRecommendedHandler();
+        
+        // 在非协程上下文中，应该根据 curl 和 stream 的可用性返回推荐的处理器
+        $this->assertIsString($recommended);
+        $this->assertContains($recommended, ['curl', 'stream', 'auto']);
+    }
+
+    /**
+     * 测试 Guzzle 客户端创建.
+     */
+    public function testCreateGuzzleClient()
+    {
+        $client = HttpHandlerFactory::createGuzzleClient([], 'stream');
+        $this->assertInstanceOf(\GuzzleHttp\Client::class, $client);
+    }
+
+    /**
+     * 测试处理器可用性检查.
+     */
+    public function testIsHandlerAvailable()
+    {
+        $this->assertTrue(HttpHandlerFactory::isHandlerAvailable('auto'));
+        
+        // stream 处理器应该在大多数环境中可用
+        $this->assertIsBool(HttpHandlerFactory::isHandlerAvailable('stream'));
+        
+        // curl 处理器的可用性取决于环境
+        $this->assertIsBool(HttpHandlerFactory::isHandlerAvailable('curl'));
+    }
+
+    /**
+     * 测试 HTTP 选项创建.
+     */
+    public function testCreateHttpOptions()
+    {
+        $baseOptions = ['timeout' => 30];
+        $options = HttpHandlerFactory::createHttpOptions($baseOptions, 'stream');
+        
+        $this->assertIsArray($options);
+        $this->assertArrayHasKey('timeout', $options);
+        $this->assertEquals(30, $options['timeout']);
+        $this->assertArrayHasKey('handler', $options);
+    }
+}
diff --git a/tests/manual/README.md b/tests/manual/README.md
new file mode 100644
index 0000000..8c9be1e
--- /dev/null
+++ b/tests/manual/README.md
@@ -0,0 +1,86 @@
+# Manual Tests
+
+This directory contains manual test scripts for verifying specific functionality.
+
+## test_http_handler.php
+
+Tests the HTTP handler factory's coroutine detection and handler selection logic.
+
+### Running the test
+
+#### In non-coroutine context (regular PHP):
+```bash
+php tests/manual/test_http_handler.php
+```
+
+Expected output:
+- `in_coroutine_context: false`
+- `recommended_handler: curl` (if cURL is available)
+
+#### In coroutine context (Hyperf/Swoole):
+
+To test in a coroutine context, create a Hyperf command with `$coroutine = true`:
+
+```php
+<?php
+namespace App\Command;
+
+use Hyperf\Command\Annotation\Command;
+use Hyperf\Odin\Api\Providers\HttpHandlerFactory;
+
+#[Command()]
+class TestHttpHandlerCommand extends \Hyperf\Command\Command
+{
+    // Enable coroutine mode (default is true)
+    protected bool $coroutine = true;
+
+    public function __construct()
+    {
+        parent::__construct('test:http-handler');
+    }
+
+    public function handle(): void
+    {
+        echo "=== HTTP Handler Test in Coroutine Context ===\n\n";
+        
+        // Test coroutine detection
+        $inCoroutine = HttpHandlerFactory::isInCoroutineContext();
+        echo "In coroutine context: " . ($inCoroutine ? "YES" : "NO") . "\n";
+        
+        // Test recommended handler
+        $recommended = HttpHandlerFactory::getRecommendedHandler();
+        echo "Recommended handler: $recommended\n";
+        echo "Expected: stream (auto-detected in coroutine)\n\n";
+        
+        // Test environment info
+        $envInfo = HttpHandlerFactory::getEnvironmentInfo();
+        echo "Environment Info:\n";
+        foreach ($envInfo as $key => $value) {
+            if (is_bool($value)) {
+                $value = $value ? 'true' : 'false';
+            } elseif (is_array($value)) {
+                continue; // Skip complex arrays
+            }
+            echo "  - $key: $value\n";
+        }
+    }
+}
+```
+
+Run with:
+```bash
+php bin/hyperf.php test:http-handler
+```
+
+Expected output in coroutine context:
+- `in_coroutine_context: true`
+- `recommended_handler: stream`
+
+## Why This Matters
+
+The automatic coroutine detection and handler switching solves the issue where:
+- Swoole compiled with older OpenSSL versions
+- cURL handler fails with "Connection refused" in HTTPS connections within coroutines
+- Stream handler works correctly in both coroutine and non-coroutine contexts
+
+The framework now automatically detects the coroutine context and switches to the stream handler to ensure compatibility.
diff --git a/tests/manual/test_http_handler.php b/tests/manual/test_http_handler.php
new file mode 100644
index 0000000..48e4d1a
--- /dev/null
+++ b/tests/manual/test_http_handler.php
@@ -0,0 +1,83 @@
+<?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
+ */
+
+/**
+ * Test script to verify coroutine detection and HTTP handler selection.
+ * 
+ * This script demonstrates:
+ * 1. Coroutine detection in non-coroutine context
+ * 2. Handler selection based on environment
+ * 3. Environment information retrieval
+ */
+
+require_once __DIR__ . '/../../src/Api/Providers/HttpHandlerFactory.php';
+
+use Hyperf\Odin\Api\Providers\HttpHandlerFactory;
+
+echo "=== HTTP Handler Factory Test ===\n\n";
+
+// Test 1: Check if in coroutine context
+echo "1. Coroutine Detection Test:\n";
+$inCoroutine = HttpHandlerFactory::isInCoroutineContext();
+echo "   In coroutine context: " . ($inCoroutine ? "YES" : "NO") . "\n";
+echo "   Expected: NO (running outside coroutine)\n\n";
+
+// Test 2: Get recommended handler
+echo "2. Recommended Handler Test:\n";
+$recommended = HttpHandlerFactory::getRecommendedHandler();
+echo "   Recommended handler: $recommended\n";
+if ($inCoroutine) {
+    echo "   Expected: stream (in coroutine context)\n";
+} else {
+    echo "   Expected: curl or stream (based on availability)\n";
+}
+echo "\n";
+
+// Test 3: Environment information
+echo "3. Environment Information:\n";
+$envInfo = HttpHandlerFactory::getEnvironmentInfo();
+foreach ($envInfo as $key => $value) {
+    if (is_bool($value)) {
+        $value = $value ? 'true' : 'false';
+    } elseif (is_array($value)) {
+        $value = json_encode($value);
+    } elseif (is_null($value)) {
+        $value = 'null';
+    }
+    echo "   - $key: $value\n";
+}
+echo "\n";
+
+// Test 4: Handler availability check
+echo "4. Handler Availability Test:\n";
+$streamAvailable = HttpHandlerFactory::isHandlerAvailable('stream');
+$curlAvailable = HttpHandlerFactory::isHandlerAvailable('curl');
+$autoAvailable = HttpHandlerFactory::isHandlerAvailable('auto');
+echo "   Stream handler available: " . ($streamAvailable ? "YES" : "NO") . "\n";
+echo "   Curl handler available: " . ($curlAvailable ? "YES" : "NO") . "\n";
+echo "   Auto handler available: " . ($autoAvailable ? "YES" : "NO") . "\n";
+echo "\n";
+
+// Test 5: Handler selection logic
+echo "5. Handler Selection Logic:\n";
+if ($inCoroutine) {
+    echo "   In coroutine context:\n";
+    echo "   - 'auto' mode will use: stream handler\n";
+    echo "   - This avoids OpenSSL compatibility issues\n";
+} else {
+    echo "   Not in coroutine context:\n";
+    echo "   - 'auto' mode will use: default Guzzle selection\n";
+    echo "   - Recommended: " . $recommended . "\n";
+}
+echo "\n";
+
+echo "=== Test Complete ===\n";