Strapi 4 中自定义无 Content-Type 的 API 端点需正确配置路由、控制器与服务，并注意控制器中必须使用 return 显式响应，而非调用 ctx.body()（该方法已弃用且不触发响应）。
strapi 4 中自定义无 content-type 的 api 端点需正确配置路由、控制器与服务，并注意控制器中必须使用 `return` 显式响应，而非调用 `ctx.body()`（该方法已弃用且不触发响应）。
在 Strapi v4 中，自定义独立 API 端点（即不绑定任何内容类型）是完全支持的，但其底层基于 Koa 框架，控制器函数必须显式返回响应值，否则 Strapi 不会自动发送 HTTP 响应——这正是导致 404（实际为无响应，被中间件/路由层判定为未匹配）的根本原因。你当前代码中 ctx.body("data", data) 写法不仅语法错误（ctx.body 是属性，非函数），而且在 Strapi v4 中已被移除；正确做法是直接 return 一个对象或使用 ctx.response.body。
以下是修正后的完整实现（含关键修复与最佳实践）：
✅ 正确的控制器写法（.src/api/lpv-banner-data/controllers/lpv-banner-data.js）
'use strict';
module.exports = {
async fetchData(ctx) {
try {
const data = await strapi.service('api::lpv-banner-data.lpv-banner-data').fetchData();
// ✅ 正确：直接 return 响应体（Strapi 自动序列化为 JSON 并设置 200 状态）
return { data };
} catch (err) {
// ✅ 正确：抛出错误，由全局错误处理器统一处理；或手动返回错误响应
ctx.response.status = 500;
return { error: 'Failed to fetch external data', details: err.message };
}
},
};✅ 路由配置优化（.src/api/lpv-banner-data/routes/lpv-banner-data.js）
module.exports = {
routes: [
{
method: 'GET',
path: '/lpv-banner-data', // ✅ 推荐显式声明完整路径，避免 prefix 模糊性
handler: 'lpv-banner-data.fetchData',
config: {
policies: [],
},
},
],
};⚠️ 注意：
prefix和controller字段在 Strapi v4 的路由文件中已被废弃，仅routes数组有效。若保留prefix，Strapi 将忽略整个配置或报错。
✅ 服务层修复（.src/api/lpv-banner-data/services/lpv-banner-data.js）
'use strict';
const axios = require('axios');
module.exports = {
async fetchData() {
try {
const response = await axios.get('https://api-endpoint'); // ✅ 替换为真实地址
// ❌ 原代码中 getPropertyTypes.json() 未定义且语法错误，已移除
return response.data;
} catch (err) {
// ✅ 抛出错误，让控制器统一处理（推荐），或返回结构化错误
throw new Error(`External API request failed: ${err.message}`);
}
},
};? 关键注意事项：
-
权限配置：即使无 Content-Type，仍需在 Admin Panel → Settings → Roles → Public（或对应角色）→
lpv-banner-data下勾选find权限（Strapi 会为自定义 API 自动生成权限条目，名称格式为api::xxx.xxx.*）。 -
开发时重启：修改路由或控制器后，必须重启 Strapi 开发服务器（
npm run develop），热重载不生效。 -
调试技巧：在控制器开头添加
console.log('Controller hit!')，确认是否进入；若无日志，说明路由未注册成功（检查路径拼写、文件位置、是否在src/api/下且命名规范）。 -
错误处理建议：避免在服务层
return err，而应throw err，由控制器捕获并返回语义化响应，利于前端判断。
完成以上修正后，访问 http://localhost:1337/lpv-banner-data 即可获得预期数据响应，不再出现 404。此方案完全满足“不依赖 Content-Type、纯逻辑端点”的需求，符合 Strapi v4 官方架构规范。
