Symfony服务器仅WSDL中hello函数可用问题求助

我来帮你排查这个问题——在Symfony的SOAP服务里新增bye方法后没出现在WSDL里，大概率是注解配置遗漏或者WSDL缓存未清除导致的，咱们一步步来解决：

1. 检查SOAP方法的注解配置 #

Symfony的SOAP服务依赖@WebMethod和@WebParam注解来识别哪些方法需要暴露到WSDL中，新增bye方法时很容易忘记添加这些注解。请确保你的控制器代码是这样的：

// src/Controller/HelloController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\WebServiceServer\Annotation\WebMethod;
use Symfony\Component\WebServiceServer\Annotation\WebParam;

class HelloController extends AbstractController
{
    /**
     * @WebMethod()
     * @WebParam(name="name")
     */
    public function hello($name)
    {
        return 'Hello, '.$name;
    }

    /**
     * @WebMethod()  // 必须添加这个注解标记为SOAP方法
     * @WebParam(name="name")  // 必须定义参数名
     */
    public function bye($name)
    {
        return 'Goodbye, '.$name;
    }

    public function index(Request $request)
    {
        $server = new \SoapServer(null, [
            'uri' => $request->getUri(),
        ]);
        $server->setObject($this);
        $server->handle();

        return new Response();
    }
}

一定要确认bye方法上的两个注解都存在，缺少任何一个都会导致SOAP服务器不把它加入WSDL。

2. 清除Symfony缓存 #

Symfony默认会缓存动态生成的WSDL文件，就算你添加了新方法，旧的缓存WSDL依然会被使用。执行以下命令清除缓存：

# 开发环境
php bin/console cache:clear --env=dev

# 生产环境
php bin/console cache:clear --env=prod

开发环境虽然有自动缓存失效机制，但偶尔也会出现缓存未更新的情况，手动清除更稳妥。

3. 验证路由配置 #

确保你的路由正确指向了SOAP控制器的index方法，没有限制只处理特定请求。路由配置应该类似这样：

# config/routes.yaml
hello_soap:
    path: /soap
    controller: App\Controller\HelloController::index
    methods: [POST]

这个路由是SOAP请求的入口，只要它正确指向控制器，带注解的方法都会被自动识别。

4. 手动生成WSDL（可选） #

如果上述步骤都尝试后还是不行，可以手动生成WSDL文件并直接使用，避免动态生成的缓存问题：

首先执行命令生成WSDL：

php bin/console generate:wsdl App\Controller\HelloController > config/hello.wsdl

然后修改控制器的index方法，指定使用这个静态WSDL文件：

public function index(Request $request)
{
    $wsdl = __DIR__.'/../../config/hello.wsdl';
    $server = new \SoapServer($wsdl);
    $server->setObject($this);
    $server->handle();

    return new Response();
}

这样生成的WSDL会包含所有带@WebMethod注解的方法，确保内容是最新的。

按照以上步骤操作后，你的bye方法应该就能正常出现在WSDL中并被调用了。

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