Amplify生成的TypeScript模型中@belongsTo关系的外键属性缺失引发VSCode编译错误

我来帮你梳理这个问题，这其实是Amplify Codegen在TypeScript和JavaScript模式下的行为差异导致的，并非你的操作有误，也算不上严格意义上的文档bug，只是文档示例没有明确区分两种语言的写法。

为什么会出现这个错误？ #

当你用TypeScript开发时，Amplify Codegen生成的模型类会把@belongsTo定义的外键（比如postID）封装成对应的关联对象属性（post），不会在ModelInit类型里暴露原始的ID字段。而JavaScript因为没有类型检查，所以可以直接传入postID，这也是为什么你改成.js文件就不报错的原因。

正确的TypeScript写法 #

你有几种方式可以解决这个问题，推荐优先使用第一种：

1. 直接传入关联的Post对象
   既然生成的Comment模型要求传入post属性，直接把之前创建好的Post实例传进去即可：

   import { DataStore } from "aws-amplify"
   import { Post, Comment, PostStatus } from "./models/index"
   async function createPost() {
     const post = await DataStore.save(
       new Post({
         title: "My Post with comments",
         rating: 10,
         status: PostStatus.ACTIVE
       })
     );
     await DataStore.save(
       new Comment({
         content: "Loving Amplify DataStore!",
         post: post // 直接传递Post对象
       })
     );
   }
   

2. 仅传入Post的ID（无需完整查询）
   如果你只有Post的ID，不想先查询完整的Post对象，可以构造一个仅包含id的Post实例（DataStore只需要ID来建立关联，其他字段可以随便填充，不会影响关联逻辑）：

   await DataStore.save(
     new Comment({
       content: "Loving Amplify DataStore!",
       post: new Post({ 
         id: post.id, 
         title: "", 
         rating: 0, 
         status: PostStatus.ACTIVE 
       })
     })
   );
   

3. 使用ModelIdentifier（部分Amplify版本支持）
   有些新版本的Amplify提供了ModelIdentifier工具，可以更简洁地关联：

   import { DataStore, ModelIdentifier } from "aws-amplify"
   import { Post, Comment, PostStatus } from "./models/index"
   
   async function createPost() {
     const post = await DataStore.save(/* ... */);
     await DataStore.save(
       new Comment({
         content: "Loving Amplify DataStore!",
         post: ModelIdentifier.for(Post, post.id)
       })
     );
   }
   

关于文档和Codegen的补充说明 #

• 官方文档里的示例是针对JavaScript的，所以可以直接使用postID，但TypeScript因为强类型约束，必须遵循生成的模型类型定义。这不算文档错误，只是文档没有明确标注JS和TS的写法差异。
• 这也不是Codegen的bug，而是TypeScript模式下的设计选择：通过强制使用关联对象来保证类型安全，避免传入无效的ID值。

内容的提问来源于stack exchange，提问作者John Rizzo