Bluehost部署的OpenSea NFT元数据API返回406错误 验证流程报无效响应

406 Not Acceptable 是服务器端的内容协商拦截机制触发的状态码，代表服务器无法根据请求携带的Accept头生成匹配的响应内容，通常不是PHP业务代码逻辑本身的报错，在Bluehost共享主机环境下有几类高频触发场景：

• 场景1：Bluehost默认ModSecurity规则拦截
  Bluehost的Apache环境默认开启ModSecurity防护规则集，会对携带Accept: application/json请求头的无文件后缀动态PHP请求做异常判定，直接返回406拦截响应。
  解决方法：在元数据接口所属的目录下新建.htaccess配置文件，关闭该路径下的规则拦截：

  <IfModule mod_security.c>
    SecFilterEngine Off
    SecFilterScanPOST Off
  </IfModule>
  # 支持无文件后缀的路径解析
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php [L,QSA]
  

• 场景2：mod_negotiation模块的内容协商冲突
  Bluehost默认开启mod_negotiation模块，会自动根据请求的Accept头匹配服务器本地的静态资源类型，由于接口是动态PHP生成的JSON响应，不存在对应的静态文件，模块会直接判定无法生成匹配的内容返回406。
  解决方法：在.htaccess配置中关闭该目录下的内容协商逻辑：

  <IfModule mod_negotiation.c>
    Options -MultiViews
  </IfModule>
  

• 场景3：PHP输出存在前置污染导致协商不匹配
  Bluehost默认的PHP配置可能会在输出内容前自动追加BOM头、空白字符，导致虽然代码设置了Content-Type: application/json，但实际响应头的格式不符合协商要求，触发406。
  优化对应PHP代码：

  <?php
  // 清除所有前置残留的输出缓冲
  ob_clean();
  // 明确设置响应头
  header('Content-Type: application/json');
  // 直接输出合规的JSON内容，避免无意义的编解码转换带来的转义问题
  echo '{
    "attributes": [
      {
        "trait_type": "Eyes", 
        "value": "cute"
      }, 
      {
        "trait_type": "Nose", 
        "value": "cute"
      }, 
      {
        "trait_type": "Cheeks", 
        "value": "cute"
      }, 
      {
        "trait_type": "Toes", 
        "value": "cute"
      }, 
      {
        "trait_type": "Ability", 
        "value": "chairs"
      }, 
      {
        "display_type": "boost_number", 
        "trait_type": "Cuteness", 
        "value": 5000
      }, 
      {
        "display_type": "number", 
        "trait_type": "Age", 
        "value": 1
      }
    ], 
    "description": "Thinking about my Mommy.", 
    "external_url": "https://mining4btc.com/NFT/rinkeby/CKE/external", 
    "image": "https://mining4btc.com/NFT/rinkeby/CKE/proof/1.jpg", 
    "name": "Chillin"
  }';
  // 终止输出，避免追加无关内容
  exit;
  ?>
  

• 快速排障验证方法
  本地执行curl命令模拟OpenSea的请求头，验证接口的实际返回状态：

  curl -I -H "Accept: application/json" https://mining4btc.com/NFT/rinkeby/CKE/1
  

  如果curl命令直接返回406，即可确认是服务器端配置拦截问题，按照上述.htaccess规则调整即可；如果curl返回200，重新触发OpenSea的校验流程即可——OpenSea的验证节点存在临时IP/请求缓存，不会实时拉取最新的接口响应。

内容的提问来源于stack exchange，提问作者Adam Winter