当合同标的物违法时，该合同无效。这是基于《中华人民共和国民法典》的相关规定得出的明确结论。下面，我将从法律依据、具体情形分析以及法律后果和建议三个方面，为您详细阐述。
法律依据
根据《中华人民共和国民法典》第一百四十三条，一个合法有效的民事法律行为需要满足三个条件：行为人具有相应的民事行为能力、意思表示真实、不违反法律、行政法规的强制性规定，不违背公序良俗。而第一百五十三条则明确规定，违反法律、行政法规的强制性规定的民事法律行为无效。此外，违背公序良俗的民事法律行为同样无效。这些规定为判断合同是否有效提供了明确的法律依据。
具体情形分析
买卖违禁品：
- 如果合同标的物为非法物品，如毒品、枪支弹药等，这些物品因其严重的社会危害性和法律禁止性，作为合同标的物将直接违反法律的强制性规定，导致合同自始无效。同时，涉及此类交易的双方还可能面临刑事法律责任。
涉及危害国家安全或严重违背公序良俗的标的物：
- 如买卖国家机密文件或人体器官等，这些行为不仅违法，而且严重损害国家利益和社会公共利益，因此合同同样无效。
部分非法与部分合法：
- 在某些特殊情况下，如果合同仅部分内容涉及非法标的物，但该部分内容可以与其他部分相分离，且不影响其他部分效力的，那么其他部分仍然可能有效。例如，一份合同中既包含合法的货物买卖条款，又偶然涉及少量非法物品的交易条款，此时合法部分的条款通常仍具法律效力。但这种情况需具体案件具体分析，并由法院根据实际情况作出判断。
法律后果和建议
法律后果：
- 一旦合同被认定为无效，那么该合同自始没有法律约束力，双方当事人均不能基于该合同主张任何权利或承担任何义务。此外，因合同违法而导致的法律后果可能还包括罚款、没收违法所得等。如果合同违法行为构成犯罪，还可能面临刑事处罚。
建议：
- 在签订合同之前，务必仔细审查合同内容，特别是合同标的的合法性。确保合同标的物不违反任何法律、行政法规的强制性规定，也不违背公序良俗。如有必要，可咨询我进行法律风险评估，以确保合同的有效性和合法性，从而避免不必要的法律风险和经济损失。
综上所述，标的物的合法性是合同有效性的重要前提。一旦合同标的物非法，该合同将被判定为无效，不受法律保护。因此，在签订合同时，请务必确保合同标的物的合法性。如果您在合同纠纷方面有任何疑问或需要进一步的法律帮助，请随时向我咨询。