Heroku部署的Lumen项目调用SoapClient提示类未找到怎么解决

这个故障是运行环境中SOAP扩展未正确加载导致的，你可以按照以下步骤排查解决：

解决方案 #

• 第一步：修正composer配置
  先删除autoload节点下无用的"classmap": [ "soapclient"]配置，SOAP是PHP原生扩展，不需要通过类映射加载。确认"ext-soap": "*"是放在require节点下（而非require-dev节点，后者仅开发环境生效）。
  修改完成后本地执行composer update ext-soap --lock命令，仅更新composer.lock中ext-soap相关的条目，避免意外升级其他依赖包。完成后务必将修改后的composer.json和composer.lock都提交到你部署到Heroku的代码分支，Heroku仅读取composer.lock文件判断需要安装的扩展。
• 第二步：验证扩展安装状态
  安装Heroku CLI后，在本地项目目录执行heroku run php -m | grep soap，如果返回soap说明扩展已正常启用；如果无返回，去查看Heroku应用的构建日志，确认构建过程中有没有加载ext-soap的相关日志输出。
  如果构建日志未出现ext-soap安装记录，执行heroku buildpacks确认首个构建包为官方的heroku/php，自定义构建包优先级过高会覆盖官方扩展安装逻辑。
• 第三步：排查运行时缓存问题
  如果扩展已经安装仍报类不存在，大概率是OPcache缓存了旧的类映射：你可以在Heroku应用的环境变量中添加PHP_OPCACHE_ENABLE=0临时关闭缓存，重新部署后测试功能是否正常。如果关闭缓存后恢复正常，说明是旧的OPcache缓存没有更新，后续部署时添加OPcache重置逻辑即可。

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