diff --git a/docs/changelog.md b/docs/changelog.md
index b5eed9ea..f501cd5b 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -6,6 +6,11 @@
 
 ## v2.2.21 (2025-12-05)
 
+### Bug Fixes
+
+- **迭代安全修复**: 修复 `process`/`lateProcess` 迭代时组件变化导致跳过实体的问题 (#272)
+  - 在系统处理过程中添加/移除组件不再导致实体被意外跳过
+
 ### Performance
 
 - **HierarchySystem 性能优化**: 优化层级系统避免每帧遍历所有实体 (#279)
diff --git a/docs/en/changelog.md b/docs/en/changelog.md
index ee775737..79c4f0fd 100644
--- a/docs/en/changelog.md
+++ b/docs/en/changelog.md
@@ -6,6 +6,11 @@ This document records the version update history of the `@esengine/ecs-framework
 
 ## v2.2.21 (2025-12-05)
 
+### Bug Fixes
+
+- **Iteration safety fix**: Fix issue where component changes during `process`/`lateProcess` iteration caused entities to be skipped (#272)
+  - Adding/removing components during system processing no longer causes entities to be unexpectedly skipped
+
 ### Performance
 
 - **HierarchySystem optimization**: Optimize hierarchy system to avoid iterating all entities every frame (#279)