Room数据库内部类@Entity注解失效，无法创建表及访问表名

问题根源 #

你的代码里Data是非静态内部类，Room无法识别这种类作为数据库实体：

• 非静态内部类会隐含持有外部类SubCategory的引用，Room不知道如何持久化这个隐含引用，导致类型转换报错。
• 非静态内部类的访问限制，导致DAO无法正确识别对应的表名。

解决步骤及修改后代码 #

1. 将Data改为静态内部类

给Data类添加static关键字，使其脱离外部类实例的依赖，Room就能正常解析它的字段作为表列。

2. 调整外部类中data字段的引用

同步修改SubCategory中ArrayList<Data>的引用为ArrayList<SubCategory.Data>。

修改后的完整代码：

public class SubCategory implements Serializable {

    private ArrayList<SubCategory.Data> data;
    private String message;

    public ArrayList<SubCategory.Data> getData() {
        return this.data;
    }

    public void setData(ArrayList<SubCategory.Data> data) {
        this.data = data;
    }

    public String getMessage() {
        return this.message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    // 核心修改：添加static关键字
    @Entity(tableName = "SubCardsCategories")
    public static class Data implements Serializable {

        @PrimaryKey
        private Integer id;
        private String name;

        public String getName() {
            return this.name;
        }

        public void setName(String name) {
            this.name = name;
        }

        public Integer getId() {
            return this.id;
        }

        public void setId(Integer id) {
            this.id = id;
        }
    }
}

3. DAO接口中正确引用Entity

DAO里通过SubCategory.Data的方式访问实体类，就能正常关联到SubCardsCategories表：

@Dao
public interface DataDao {
    @Insert
    void insertData(SubCategory.Data data);

    @Query("SELECT * FROM SubCardsCategories")
    List<SubCategory.Data> getAllData();
}

说明 #

• 静态内部类不依赖外部类实例，Room可以完整解析它的字段生成数据表，解决类型转换报错。
• 如果SubCategory只是用来接收API返回的JSON结构（而非需要持久化到数据库），当前修改完全满足需求：Data作为独立表被Room管理，SubCategory负责解析外层的数组和消息字段。

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