WordPress 在尝试从 wordpress.org 下载主题或插件时抛出 “cURL error 28: Resolving timed out” 错误，通常并非 DNS 或网络连通性问题，而是因 PHP 缺少关键扩展（如 php-xmlrpc）导致 WordPress 无法正确发起远程 API 请求。
wordpress 在尝试从 wordpress.org 下载主题或插件时抛出 “curl error 28: resolving timed out” 错误，通常并非 dns 或网络连通性问题，而是因 php 缺少关键扩展（如 `php-xmlrpc`）导致 wordpress 无法正确发起远程 api 请求。
该错误表面看是“DNS 解析超时”，但实际排查中常发现：curl -I https://api.wordpress.org 可正常响应、/etc/hosts 手动映射 IP 无效、防火墙已关闭、DNS 已切换至 8.8.8.8——这些都说明底层网络通畅。真正根源在于 WordPress 核心依赖 PHP-XMLRPC 扩展来与 api.wordpress.org 进行安全通信（尤其是验证、检索及下载元数据），而 Ubuntu 官方部分教程仅安装了基础 PHP 模块，遗漏了此项关键依赖。
✅ 正确修复步骤如下：
-
安装缺失的 PHP 扩展
在 Ubuntu 20.04 环境下，运行以下命令补全 WordPress 所需的完整 PHP 支持模块：
sudo apt update sudo apt install php-gd php-xmlrpc php-soap
? 补充说明：
- php-xmlrpc：WordPress 更新/安装流程必须通过 XML-RPC 协议调用 api.wordpress.org 接口，缺失则直接触发 cURL 28（本质是请求未发出，而非超时）；
- php-gd：用于图像处理（主题预览缩略图生成等）；
- php-soap：部分插件及企业级功能依赖，亦被 WordPress 核心健康检查间接调用。
-
重启 Web 服务以加载新扩展
accurLex专业合同审查下载基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
sudo systemctl restart apache2 # 或若使用 Nginx + PHP-FPM： # sudo systemctl restart php7.4-fpm nginx
-
验证扩展是否启用
php -m | grep -E "(xmlrpc|gd|soap)"
应输出 xmlrpc、gd、soap 三行。也可在 WordPress 后台 →「工具」→「站点健康」→「信息」→「PHP 设置」中确认。
⚠️ 注意事项与常见误区：
- ❌ 不要盲目调高 curl.timeout 或 default_socket_timeout：此错误非超时参数问题，而是请求根本未构造完成；
- ❌ 避免修改 /etc/hosts 强制绑定 api.wordpress.org：该域名使用 CDN 和多 IP 轮询，硬编码单 IP 反而可能失效；
- ✅ 建议同步安装 php-ctype 和 php-fileinfo（虽非本例主因，但属 WordPress 官方推荐依赖）；
- ? 若后续仍遇问题，可在 wp-config.php 顶部临时添加定义以跳过 SSL 验证（仅调试用，生产环境禁用）：
define('WP_HTTP_BLOCK_EXTERNAL', false); define('FS_METHOD', 'direct');
完成上述操作后，返回 WordPress 后台 →「外观」→「主题」或「插件」→「添加新」，点击任意主题/插件的「安装」按钮，即可秒级完成下载与激活，不再出现 cURL 28 报错。这印证了一个关键事实：WordPress 的远程功能高度依赖完整的 PHP 扩展栈，而非单纯网络配置——精准补全依赖，远胜于泛泛排查网络层。
