本地Docker环境下WooCommerce REST API启用HTTP基础认证方案咨询

方案1：给本地环境配置HTTPS（最贴合生产场景） #

这是最推荐的方案，完全模拟生产环境的HTTPS环境，能避免后续其他潜在问题：

• 用mkcert生成本地信任的SSL证书：
  1. 按系统安装mkcert（比如Mac用brew install mkcert，Windows用Chocolatey安装）
  2. 生成本地CA信任：mkcert -install
  3. 在项目目录下生成证书：mkcert localhost 127.0.0.1，会得到localhost+1.pem和localhost+1-key.pem两个文件
• 修改docker-compose.yml，添加Nginx代理服务并配置SSL：
  示例配置片段：

  services:
    nginx:
      image: nginx:alpine
      ports:
        - "443:443"
      volumes:
        - ./nginx.conf:/etc/nginx/conf.d/default.conf
        - ./localhost+1.pem:/etc/ssl/certs/localhost.pem
        - ./localhost+1-key.pem:/etc/ssl/private/localhost-key.pem
      depends_on:
        - wordpress
    wordpress:
      image: wordpress:latest
      # 保留原有WordPress容器配置...
  

• 编写nginx.conf，配置反向代理到WordPress容器并开启SSL：

  server {
    listen 443 ssl;
    server_name localhost;
  
    ssl_certificate /etc/ssl/certs/localhost.pem;
    ssl_certificate_key /etc/ssl/private/localhost-key.pem;
  
    location / {
      proxy_pass http://wordpress;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto $scheme;
    }
  }
  

• 重启Docker Compose服务，之后用https://localhost访问WordPress，再用基础认证请求API即可正常工作。

方案2：临时禁用WooCommerce的HTTPS强制检查（仅限开发环境） #

注意：此方法仅用于本地测试，绝对不能在生产环境使用：

• 找到WooCommerce插件目录下的includes/class-wc-rest-authentication.php文件
• 定位到check_is_secure()方法，修改返回逻辑：
  原代码大致如下：

  protected function check_is_secure() {
    if ( ! is_ssl() ) {
      throw new WC_REST_Authentication_Exception( 'woocommerce_rest_https_required', __( 'HTTPS is required to use authentication.', 'woocommerce' ), 401 );
    }
  }
  

  修改为：

  protected function check_is_secure() {
    // 本地开发环境跳过HTTPS检查
    if ( ! is_ssl() && $_SERVER['HTTP_HOST'] !== 'localhost' && strpos($_SERVER['HTTP_HOST'], '127.0.0.1') === false ) {
      throw new WC_REST_Authentication_Exception( 'woocommerce_rest_https_required', __( 'HTTPS is required to use authentication.', 'woocommerce' ), 401 );
    }
  }
  

• 保存文件后刷新WordPress，本地HTTP环境下使用基础认证请求API就不会返回401错误。

方案3：改用OAuth 1.0a认证方式 #

WooCommerce API支持OAuth 1.0a认证，这种方式不依赖HTTPS（生产环境仍推荐HTTPS）：

• 在WordPress后台的「WooCommerce > 设置 > 高级 > REST API」中，创建OAuth 1.0a类型的密钥对（消费者密钥、消费者密码）
• 请求API时，按照OAuth 1.0a规范生成签名，比如用Postman选择OAuth 1.0授权类型，填入密钥信息后自动生成签名再发送请求
• 这种方式无需修改代码，也不受HTTP环境限制，适合快速测试。

内容的提问来源于stack exchange，提问作者La Vora Dev