befly 3.9.14 → 3.9.21

package/checks/checkTable.ts

@@ -37,6 +37,11 @@ const RESERVED_FIELDS = ['id', 'created_at', 'updated_at', 'deleted_at', 'state'
  */
 const FIELD_TYPES = ['string', 'number', 'text', 'array_string', 'array_text'] as const;
 
+/**
+ * 允许的字段属性列表
+ */
+const ALLOWED_FIELD_PROPERTIES = ['name', 'type', 'min', 'max', 'default', 'detail', 'index', 'unique', 'nullable', 'unsigned', 'regexp'] as const;
+
 /**
  * 小驼峰命名正则
  * 可选：以下划线开头（用于特殊文件，如通用字段定义）
@@ -133,6 +138,14 @@ export async function checkTable(): Promise<void> {
                     // 直接使用字段对象
                     const field = fieldDef as FieldDefinition;
 
+                    // 检查是否存在非法属性
+                    const fieldKeys = Object.keys(field);
+                    const illegalProps = fieldKeys.filter((key) => !ALLOWED_FIELD_PROPERTIES.includes(key as any));
+                    if (illegalProps.length > 0) {
+                        Logger.warn(`${item.typeName}表 ${fileName} 文件 ${colKey} 包含非法属性: ${illegalProps.join(', ')}，` + `允许的属性为: ${ALLOWED_FIELD_PROPERTIES.join(', ')}`);
+                        hasError = true;
+                    }
+
                     // 检查必填字段：name, type
                     if (!field.name || typeof field.name !== 'string') {
                         Logger.warn(`${item.typeName}表 ${fileName} 文件 ${colKey} 缺少必填字段 name 或类型错误`);
@@ -193,6 +206,11 @@ export async function checkTable(): Promise<void> {
                         hasError = true;
                     }
 
+                    // 检查 unique 和 index 冲突（警告但不阻断）
+                    if (field.unique && field.index) {
+                        Logger.warn(`${item.typeName}表 ${fileName} 文件 ${colKey} 同时设置了 unique=true 和 index=true，` + `unique 约束会自动创建唯一索引，index=true 将被忽略以避免重复索引`);
+                    }
+
                     // 约束：当最小值与最大值均为数字时，要求最小值 <= 最大值
                     if (fieldMin !== undefined && fieldMax !== undefined && fieldMin !== null && fieldMax !== null) {
                         if (fieldMin > fieldMax) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.9.14",
+    "version": "3.9.21",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -74,7 +74,7 @@
         "pino": "^10.1.0",
         "pino-roll": "^4.0.0"
     },
-    "gitHead": "9f37fe1d7b660c79cbee174865b9d65b1a4ead22",
+    "gitHead": "d0825d638bbb779137fb8860049bcc1b3200a5dc",
     "devDependencies": {
         "typescript": "^5.9.3"
     }

package/sync/syncDb/table.ts

@@ -161,7 +161,8 @@ export async function modifyTable(sql: SQL, tableName: string, fields: Record<st
         const dbFieldName = snakeCase(fieldKey);
 
         const indexName = `idx_${dbFieldName}`;
-        if (fieldDef.index && !existingIndexes[indexName]) {
+        // 如果字段有 unique 约束，跳过创建普通索引（unique 会自动创建唯一索引）
+        if (fieldDef.index && !fieldDef.unique && !existingIndexes[indexName]) {
             indexActions.push({ action: 'create', indexName: indexName, fieldName: dbFieldName });
             changed = true;
         } else if (!fieldDef.index && existingIndexes[indexName] && existingIndexes[indexName].length === 1) {