Angular 7点击按钮无法打开PDF，报Missing controller错误求助

报错"Missing controller"是CakePHP路由解析逻辑导致的——默认路由规则下，/api/report/1234.pdf会被解析为ReportController控制器，但项目中要么不存在该控制器，要么这条路由没有正确映射到PDF生成逻辑。浏览器无法识别PDF，本质是后端返回了错误页面而非合法的PDF文件。

1. 配置CakePDF路由规则 #

在CakePHP项目的config/routes.php中添加专属路由，让/api/report/{id}.pdf格式的请求指向正确的控制器方法：

// 匹配/api/report/xxx.pdf格式请求，映射到Reports控制器的viewPdf方法
$routes->connect(
    '/api/report/:id.pdf',
    ['controller' => 'Reports', 'action' => 'viewPdf'],
    ['pass' => ['id'], 'id' => '\d+'] // 限制id为数字，可根据实际需求调整规则
);

2. 实现PDF响应的控制器方法 #

创建或修改src/Controller/ReportsController.php，添加viewPdf方法，确保返回正确的PDF响应头与文件：

namespace App\Controller;

use Cake\Http\Response;

class ReportsController extends AppController
{
    public function viewPdf($id)
    {
        // 替换为实际的PDF生成/存储逻辑，比如从数据库获取数据生成PDF，或者读取服务器上的现成文件
        $pdfPath = WWW_ROOT . 'files' . DS . 'reports' . DS . $id . '.pdf';
        
        // 检查文件是否存在
        if (!file_exists($pdfPath)) {
            throw new \Cake\Error\NotFoundException('PDF文件不存在');
        }
        
        // 设置响应头，告知浏览器这是PDF文件
        $response = $this->response;
        $response = $response->withType('application/pdf');
        $response = $response->withFile($pdfPath, ['download' => false]); // false表示在浏览器打开，true则触发下载
        
        return $response;
    }
}

3. 前端点击逻辑校验 #

确保Angular前端的按钮点击事件没有被路由拦截，正确调用浏览器新标签页打开链接：

// 组件中的点击事件方法
openPdf() {
    const pdfUrl = 'http://localhost/api/report/1234.pdf';
    window.open(pdfUrl, '_blank');
}

如果前端配置了路由代理，需确认/api前缀已正确指向CakePHP后端，比如在src/proxy.conf.json中配置：

{
    "/api/*": {
        "target": "http://localhost:8765", // 替换为你的CakePHP后端服务端口
        "secure": false,
        "changeOrigin": true
    }
}

4. 后端响应验证 #

直接在浏览器地址栏访问http://localhost/api/report/1234.pdf，如果能正常加载PDF，说明后端配置无误；若仍报错，检查以下几点：

• 控制器文件命名是否符合CakePHP规范（首字母大写，如ReportsController.php）
• 路由规则是否未被其他路由覆盖
• PDF文件路径是否正确、服务器是否有读取权限

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