Strapi 5.8.1(TypeScript)中SocketIO挂载报错：Property 'io'不存在

你遇到的Property 'io' does not exist on type 'Strapi'.ts(2339)错误，是因为Strapi v5的TypeScript类型定义中，Core.Strapi接口并没有预设io属性，而你参考的教程是针对Strapi v4的，v4的类型系统允许这种扩展，v5则做了更严格的类型约束。

有两种方式可以解决这个类型错误：

1. 临时类型断言（快速修复） #

直接将strapi断言为any类型，绕过TypeScript的类型检查：

(strapi as any).io = io;

这种方式简单直接，但会失去TypeScript的类型提示能力，适合快速验证功能。

2. 扩展Strapi类型（规范做法） #

通过自定义类型声明文件，扩展Core.Strapi接口，添加io属性的类型定义，步骤如下：

• 在项目的src目录下创建types/strapi.d.ts文件（如果types目录不存在则新建）
• 在文件中写入以下代码：

  import { Core } from '@strapi/strapi';
  import { Server } from 'socket.io';
  
  declare module '@strapi/strapi' {
    export interface Core {
      Strapi: Core.Strapi & {
        io: Server;
      };
    }
  }
  

• 确保你的tsconfig.json文件中包含这个类型文件的路径，比如在include数组中添加：

  "include": [
    "src/**/*",
    "src/types/**/*.d.ts"
  ]
  

这样TypeScript就能识别strapi.io属性，同时保留完整的类型提示。

你的代码中注册了两个connection事件监听器，可以合并为一个，避免逻辑冗余：

io.use(async (socket, next) => {
  // 认证逻辑...
}).on('connection', function (socket) {
  if (interval) clearInterval(interval);
  console.log('User connected');

  interval = setInterval(() => io.emit('serverTime', { time: new Date().getTime() }), 1000);

  socket.on('disconnect', () => {
    console.log('user disconnected');
    clearInterval(interval);
  });
});

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