WSO2 API Manager 4.1.0创建API名称超50字符报错的解决咨询

可以根据需求修改API名称的最大字符数限制，需从前端验证、后端配置/代码、数据库字段三个层面进行调整，具体步骤如下：

1. 修改前端验证规则 #

报错提示来自开发者门户的前端表单验证，需调整对应限制：

• 进入<APIM_HOME>/repository/deployment/server/jaggeryapps/devportal/src目录
• 找到API创建表单的验证逻辑文件（通常在src/components/API/CreateAPI/或类似路径下）
• 定位到名称字段的长度校验代码，将maxLength: 50修改为目标数值（如100）
• 重启WSO2 AM服务使修改生效

2. 调整后端验证配置 #

后端同样存在字段长度校验，需对应修改：

• 检查<APIM_HOME>/repository/conf/deployment.toml是否有API名称长度的配置项，若有直接修改数值
• 若配置文件无对应项，进入<APIM_HOME>/repository/resources/api-definitions/，找到包含API元数据的Swagger/OpenAPI文件，将name字段的maxLength值调整为目标数值
• 若存在硬编码的验证逻辑（如Carbon APIMGT组件中的校验类），需修改对应Java代码并重新打包部署（此步骤需具备WSO2二次开发能力）

3. 扩展数据库字段长度 #

API名称存储在数据库中，需修改对应表字段的长度限制：

• 登录WSO2 AM使用的数据库（如MySQL、PostgreSQL）
• 执行SQL语句修改AM_API表的NAME字段长度（以MySQL为例）：

  ALTER TABLE AM_API MODIFY COLUMN NAME VARCHAR(100);
  

• 若API版本、API产品等关联表的NAME字段也存在长度限制，需同步执行类似修改语句

注意事项 #

• 操作前请备份WSO2配置文件和数据库
• 修改完成后重启WSO2 AM服务
• 测试创建名称长度符合新限制的API，验证是否正常保存且无报错

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