如何解决AWS ELB对Magento2实例健康检查返回302的问题？

这是个非常典型的Magento与ELB搭配时的配置痛点，我给你几个既能让健康检查正常工作，又能真正验证Magento服务状态的方案，你可以根据自己的环境选择：

方案1：在Web服务器层面修改健康检查请求的Host头（最简单高效） #

ELB的健康检查请求是从VPC内网IP发起的，而Magento会根据请求的Host头判断当前域名是否匹配设置的基础URL，不匹配就会触发重定向。我们可以在Nginx/Apache里针对ELB的内网IP段，强制把Host头改成EC2实例的内网IP或localhost，这样Magento就不会跳转到ELB公网DNS了。

Nginx配置示例 #

server {
    # 其他常规配置...

    # 定义ELB健康检查的IP段（替换成你的VPC内网CIDR，比如10.0.0.0/24）
    set $elb_health_cidr "10\.0\.0\.0/24";

    # 针对ELB健康检查请求修改Host头
    if ($remote_addr ~* $elb_health_cidr) {
        set $custom_host "localhost"; # 也可以用EC2的内网IP或域名
    }

    proxy_set_header Host $custom_host;

    # 配置健康检查路径（搭配后面的自定义端点使用）
    location /magento-health {
        try_files $uri $uri/ /index.php?$args;
    }
}

Apache配置示例 #

# 匹配ELB健康检查的IP段
SetEnvIf Remote_Addr "10\.0\.0\.0/24" ELB_HEALTH_CHECK

# 针对健康检查请求修改Host头
RewriteCond %{ENV:ELB_HEALTH_CHECK} On
RewriteRule ^ - [E=HTTP_HOST:localhost]

# 配置健康检查路径
RewriteRule ^/magento-health /index.php [L]

方案2：创建自定义Magento健康检查控制器（真正验证服务状态） #

如果想让健康检查不仅返回200，还能验证Magento的核心服务（比如数据库连接、缓存可用性），可以创建一个简单的自定义模块，添加专属的健康检查端点：

1. 创建模块基础结构
   在app/code/Vendor/HealthCheck目录下创建以下文件：

   • registration.php

     <?php
     \Magento\Framework\Component\ComponentRegistrar::register(
         \Magento\Framework\Component\ComponentRegistrar::MODULE,
         'Vendor_HealthCheck',
         __DIR__
     );
     

   • etc/module.xml

     <?xml version="1.0"?>
     <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
         <module name="Vendor_HealthCheck" setup_version="1.0.0">
             <sequence>
                 <module name="Magento_Framework"/>
             </sequence>
         </module>
     </config>
     

2. 添加路由配置
   创建etc/frontend/routes.xml：

   <?xml version="1.0"?>
   <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
       <router id="standard">
           <route id="healthcheck" frontName="healthcheck">
               <module name="Vendor_HealthCheck"/>
           </route>
       </router>
   </config>
   

3. 编写健康检查控制器
   创建Controller/Index/Index.php：

   <?php
   namespace Vendor\HealthCheck\Controller\Index;
   
   use Magento\Framework\App\Action\Action;
   use Magento\Framework\App\Action\Context;
   use Magento\Framework\App\ResponseInterface;
   use Magento\Framework\DB\Adapter\AdapterInterface;
   use Magento\Framework\App\ResourceConnection;
   use Magento\Framework\Cache\FrontendInterface;
   
   class Index extends Action
   {
       protected $resourceConnection;
       protected $cacheFrontend;
   
       public function __construct(
           Context $context,
           ResourceConnection $resourceConnection,
           FrontendInterface $cacheFrontend
       ) {
           $this->resourceConnection = $resourceConnection;
           $this->cacheFrontend = $cacheFrontend;
           parent::__construct($context);
       }
   
       public function execute()
       {
           // 检查数据库连接
           try {
               /** @var AdapterInterface $connection */
               $connection = $this->resourceConnection->getConnection();
               if (!$connection->isConnected()) {
                   $this->getResponse()->setStatusHeader(503, '1.1', 'Service Unavailable');
                   $this->getResponse()->setBody('Database connection failed');
                   return;
               }
           } catch (\Exception $e) {
               $this->getResponse()->setStatusHeader(503, '1.1', 'Service Unavailable');
               $this->getResponse()->setBody('Database error: ' . $e->getMessage());
               return;
           }
   
           // 检查缓存服务
           try {
               if (!$this->cacheFrontend->isValid()) {
                   $this->getResponse()->setStatusHeader(503, '1.1', 'Service Unavailable');
                   $this->getResponse()->setBody('Cache service unavailable');
                   return;
               }
           } catch (\Exception $e) {
               $this->getResponse()->setStatusHeader(503, '1.1', 'Service Unavailable');
               $this->getResponse()->setBody('Cache error: ' . $e->getMessage());
               return;
           }
   
           // 所有检查通过，返回健康状态
           $this->getResponse()->setStatusHeader(200, '1.1', 'OK');
           $this->getResponse()->setBody('Magento is running healthy');
       }
   }
   

4. 启用模块并部署
   执行以下命令：

   bin/magento module:enable Vendor_HealthCheck
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy -f # 针对生产环境
   bin/magento cache:flush
   

5. 配置ELB健康检查
   将健康检查路径设置为/healthcheck/index/index，同时确保ELB的健康检查请求使用HTTP（或HTTPS，根据你的配置），端口对应正确。

方案3：修改Magento的index.php（快速临时方案） #

如果不想建模块，可以直接修改根目录的index.php，在加载Magento应用之前，针对ELB的健康检查IP临时调整请求参数：

// 在index.php的最开头添加以下代码
$elbHealthIps = ['10.0.0.0/24']; // 替换成你的ELB健康检查IP段
$clientIp = $_SERVER['REMOTE_ADDR'];

// 检查请求是否来自ELB健康检查IP
foreach ($elbHealthIps as $cidr) {
    list($ip, $mask) = explode('/', $cidr);
    $ipLong = ip2long($ip);
    $clientIpLong = ip2long($clientIp);
    $maskLong = -1 << (32 - (int)$mask);
    
    if (($clientIpLong & $maskLong) === ($ipLong & $maskLong)) {
        // 强制设置Host头为localhost，避免重定向
        $_SERVER['HTTP_HOST'] = 'localhost';
        break;
    }
}

// 原来的index.php代码
require __DIR__ . '/app/bootstrap.php';
...

总结：优先推荐方案1+方案2的组合，既解决了重定向问题，又能真正验证Magento的核心服务状态；如果是临时测试，方案3可以快速生效。

内容的提问来源于stack exchange，提问作者Shawn Northrop