在合同债务纠纷中，诉讼时效的起算时间是一个关键的法律问题，它直接关系到权利人能否在法定期间内通过法律途径有效保护自己的权益。以下是对合同债务诉讼时效起算时间的详细解答：

一、总体原则

根据《中华人民共和国民法典》的相关规定，向人民法院请求保护民事权利的诉讼时效期间通常为三年。这一期间自权利人知道或者应当知道权利受到损害以及义务人之日起计算。若超过此时间，除非存在诉讼时效中止或中断的特殊情况，否则法院可能不再受理相关案件。

二、具体情形下的诉讼时效起算时间

1. 约定履行期限的合同：

   • 对于明确约定了履行期限的合同，诉讼时效从履行期限届满之日起开始计算。例如，若合同中规定债务人应在某年某月某日前支付款项，而债务人未按时支付，则诉讼时效从该期限届满的次日起计算。

2. 未约定履行期限的合同：

   • 若合同未约定履行期限，但后续通过补充协议等方式确定了履行期限，诉讼时效从该期限届满之日起计算。
   • 若无法确定履行期限，债权人可随时要求债务人履行债务，但需给予对方必要的准备时间（宽限期）。诉讼时效从宽限期届满之日起计算。若债务人在债权人第一次主张权利时明确表示不履行义务，则诉讼时效从债务人明确表示不履行义务之日起计算。

3. 分期履行的合同：

   • 对于分期履行的债务，诉讼时效期间自最后一期履行期限届满之日起计算。这意味着，即使部分债务已经逾期，但只要整体合同的最后一期履行期限尚未届满，诉讼时效就不会开始计算。

4. 合同被撤销的情形：

   • 若合同因欺诈、胁迫等原因被撤销，返还财产、赔偿损失请求权的诉讼时效期间从合同被撤销之日起计算。例如，若因受欺诈而签订的合同被法院判决撤销，则诉讼时效从判决撤销合同的次日起计算。

5. 其他特殊情形：

   • 如当事人一方向对方当事人作出分期履行、部分履行、提供担保、请求延期履行、制定清偿债务计划等承诺或者行为的，诉讼时效可能从中断时起重新计算。
   • 对于请求他人不作为的债权请求权，诉讼时效自权利人知道义务人违反不作为义务时起算。
   • 因侵权行为而发生的赔偿请求权，诉讼时效从受害人知道或者应当知道其权利被侵害或者损害发生时起算。若侵权行为持续发生，诉讼时效从侵权行为实施终了之日起算。

三、最长诉讼时效

除了上述的一般诉讼时效外，还有最长诉讼时效的规定。根据《中华人民共和国民法典》第一百八十八条第二款，自权利受到损害之日起超过二十年的，人民法院不予保护。有特殊情况的，人民法院可以根据权利人的申请决定延长。这一规定为权利人提供了一个更长的保护期限，但同时也强调了及时行使权利的重要性。

四、建议

为确保自身权益不受侵害，建议合同双方在签订合同时明确约定履行期限及相关权利义务。在合同履行过程中保持沟通与合作，及时解决潜在纠纷。一旦发现权利受损，应及时咨询专业律师并采取法律措施以维护自身合法权益。同时，也要注意诉讼时效的起算时间和期间，避免因超过诉讼时效而丧失法律保护的机会。