Google Datastore控制台与GAE Java JDO库行为差异及ShortBlob异常

我之前也碰到过类似的Datastore控制台行为异常，结合你提供的细节，咱们来拆解问题根源和对应的解决思路：

问题核心原因 #

你遇到的本质问题是Cloud Datastore控制台的编辑逻辑存在异常：当你通过控制台修改实体（哪怕只是修改无关字段如name），它会自动修改ShortBlob类型字段的索引状态。

根据Java Datastore API的定义：

• ShortBlob是默认需要索引的字段，存入时不会携带excludeFromIndexes属性
• Blob是默认排除索引的字段，存入时会标记excludeFromIndexes: true

控制台的更新逻辑现在会把所有未在控制台手动标记为“索引”的字段，强制加上excludeFromIndexes: true——这就直接把原本的ShortBlob改成了Blob的属性。而JDO加载实体时，会按照实体类映射的ShortBlob类型去转换底层的Blob数据，自然就抛出java.lang.ClassCastException: com.google.appengine.api.datastore.Blob cannot be cast to com.google.appengine.api.datastore.ShortBlob异常了。

你通过JSON API看到的字段差异也完全验证了这一点：编辑前的testShortBlob没有excludeFromIndexes属性，编辑后被强制添加，字段的类型属性已经被篡改。

可行的解决办法 #

1. 临时规避：停止使用控制台编辑实体 #

如果业务允许，先改用代码（JDO或Datastore原生API）来更新实体，这样能严格保证字段的索引状态和类型符合JDO的映射规则，不会触发控制台的自动修改逻辑。

2. 恢复已损坏的数据 #

对于已经被控制台修改过的实体，你可以用Datastore API批量修复，把被改成Blob的字段重新设置为ShortBlob，恢复它的索引状态：

DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();
Query accountQuery = new Query("Account");
PreparedQuery preparedQuery = datastore.prepare(accountQuery);

for (Entity accountEntity : preparedQuery.asIterable()) {
    // 获取被修改的Blob字段
    Blob blobValue = (Blob) accountEntity.getProperty("testShortBlob");
    if (blobValue != null) {
        // 重新设置为ShortBlob，自动恢复索引属性
        accountEntity.setProperty("testShortBlob", new ShortBlob(blobValue.getBytes()));
        datastore.put(accountEntity);
    }
}

3. 长期适配：修改JDO映射兼容两种类型 #

如果控制台的这个问题短期内无法修复，你可以修改实体类的映射，让字段兼容ShortBlob和Blob两种类型，避免类型转换异常：

import javax.jdo.annotations.PersistenceCapable;
import javax.jdo.annotations.Persistent;
import com.google.appengine.api.datastore.Blob;
import com.google.appengine.api.datastore.ShortBlob;

@PersistenceCapable
public class Account {

    @Persistent
    private Blob testShortBlob;

    // 兼容原有ShortBlob的设置方法
    public void setTestShortBlob(ShortBlob shortBlob) {
        this.testShortBlob = new Blob(shortBlob.getBytes());
    }

    // 兼容原有ShortBlob的获取方法
    public ShortBlob getTestShortBlob() {
        return new ShortBlob(this.testShortBlob.getBytes());
    }
}

4. 根源解决：向Google反馈bug #

你可以通过Google Cloud支持中心提交这个控制台的异常问题，说明“编辑实体时错误修改ShortBlob字段的索引状态”，请求官方修复这个逻辑漏洞——这是从根源解决问题的最佳途径。

内容的提问来源于stack exchange，提问作者Ashley Schroder