讲师中心 微信公众号
AI工具推荐 视频效率加速

PHP短信接口发送失败怎么办_发送失败常见原因排查【解决】

落伟大大_5154

落伟大大_5154

发布时间:2026-02-14 18:46:03

|

424人浏览过

|

来源于php中文网

原创

PHP调用短信接口返回空响应或curl_exec返回false,主因是请求未发出:未设CURLOPT_RETURNTRANSFER导致响应直接输出、SSL校验误关致握手失败、URL末尾斜杠引发301重定向且未启用CURLOPT_FOLLOWLOCATION。

php短信接口发送失败怎么办_发送失败常见原因排查【解决】

PHP调用短信接口返回空响应或curl_exec返回false

这通常不是短信服务商拒绝你,而是请求根本没发出去。检查curl_init后是否漏掉curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)——没设这个,curl_exec默认直接输出响应体,PHP脚本可能因header已发送而报错,最终看起来像“没返回”。

还要确认curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)是否被误加在生产环境(部分服务商证书链完整,强制跳过校验反而导致握手失败)。

  • 用curl_getinfo($ch, CURLINFO_HTTP_CODE)看实际HTTP状态码,200以外都得查原因
  • 开启CURLOPT_VERBOSE并重定向STDERR到文件,能直接看到SSL握手、DNS解析、连接超时等底层细节
  • 如果服务商文档写的是POST /api/v1/send,但你拼成了/api/v1/send/(末尾斜杠),有些网关会301重定向,而你的cURL默认不跟随,结果返回空

返回{"code":1001,"msg":"签名错误"}类JSON但签名明明核对过了

签名错误最常踩的坑不是算法写错,而是参数排序和编码没对齐。比如服务商要求按字典序排序参数,但你用了ksort()却没设SORT_STRING标志,数字键名"10"排在"2"前面;又或者http_build_query默认用urlencode,但对方要求rawurlencode(空格转%20而非+)。

另一个隐蔽点:时间戳字段timestamp必须是秒级整数,但PHP time()没问题,microtime(true)取整后若没(int)强转,可能带小数点,签名计算就全错。

立即学习“PHP免费学习笔记(深入)”;

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • 把待签名字符串原样打印出来,和文档示例逐字符比对,特别注意空格、换行、等号前后
  • 签名密钥是否混用了app_secret和api_key?有些平台控制台显示“API Key”,实际签名用的是“App Secret”
  • 测试时别用file_get_contents('php://input')模拟请求——它不触发$_POST,而你签名逻辑可能依赖$_POST数组顺序

PHP-FPM环境下curl超时但命令行curl -X POST正常

这不是网络问题,是PHP运行时限制。FPM子进程的max_execution_time默认30秒,而某些短信网关在高负载时响应可能卡在5~8秒;更关键的是curl自身的CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT若没显式设置,会继承PHP全局超时,导致连接刚建立就被中断。

此外,FPM配置中request_terminate_timeout若设得太短(比如10s),哪怕cURL设了30秒超时,PHP也会在10秒后直接kill进程,返回502或空白页。

  • 在cURL初始化后立即设置:curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); curl_setopt($ch, CURLOPT_TIMEOUT, 15);
  • 检查php.ini里max_execution_time是否被动态函数如set_time_limit(0)覆盖——线上禁用该函数更安全
  • 用strace -p $(pgrep php-fpm) -e trace=connect,sendto,recvfrom抓系统调用,确认是卡在DNS解析、TCP建连,还是服务端迟迟不发回包

使用file_get_contents配stream_context_create发短信总提示400 Bad Request

这个组合看似简洁,实则对HTTP头控制极弱。file_get_contents发POST时,Content-Type默认是application/x-www-form-urlencoded,但多数短信接口要求application/json;而且它无法精细控制User-Agent、Connection等头字段,有些网关会拦截无User-Agent或Connection: close的请求。

更麻烦的是,当POST数据是JSON字符串时,你得手动json_encode再塞进http.build_body,稍有不慎就多一层引号或转义错误。

  • 改用curl——它对Header、Body、编码的控制粒度远高于file_get_contents
  • 如果坚持用file_get_contents,必须显式设置Content-Type: application/json,且body字段值必须是合法JSON字符串,不能是PHP数组
  • 注意stream_context_create的http选项里method要大写"POST",小写会被忽略,退化为GET

真正卡住的往往不是签名或URL,而是cURL的SSL版本、TLS握手选项、或FPM子进程资源限制这些底层细节。调试时先确认请求是否发出、发出后服务端收到什么、服务端返回什么——三段拆开验证,比盯着PHP代码猜快得多。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3442

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3959

2025.09.10

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

3723

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

855

2023.10.30

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2844

2023.09.04

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn